mcpField
S
stillos-swap-mcp

stillos-swap-mcp

Local
github.com/stillmarcus24Finance0Updated 5w ago
Repository

About stillos-swap-mcp

stillos-swap-mcp is a Solana swap MCP server for agents, routing trades through Jupiter and returning unsigned transactions for users to sign. It also checks token mint and freeze authorities before purchases.

Key features

  1. 01Jupiter-routed Solana swaps
  2. 02Unsigned transaction output
  3. 030.25% router fee
  4. 04On-chain mint and freeze checks
  5. 05Read-only token scam checks

Use cases

  1. 01Build a swap for self-signing
  2. 02Check token authorities before buying
  3. 03Inspect a mint without providing keys

MCP support

Exposes swap construction and token scam-check tools to MCP clients. Swap transactions are returned unsigned; the client or user signs and broadcasts them.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "stillmarcus24-stillos-swap": {
      "command": "npx",
      "args": [
        "-y",
        "stillos-swap-mcp"
      ]
    }
  }
}
Run commandnpx -y stillos-swap-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmstillos-swap-mcp1.0.0

Tools

2

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
amountnumberYesamount of inputMint to swap, in whole units (e.g. 0.5 for 0.5 SOL)
inputMintstringYesmint address of the token you are selling, or "SOL"/"USDC"/"USDT"
outputMintstringYesmint address of the token you are buying, or "SOL"/"USDC"/"USDT"
userPublicKeystringYesthe wallet that will sign and pay (your Solana public key)

Details

From the project README

stillos-swap-mcp

Non-custodial Solana swap routing for agents. Best-price execution via Jupiter, a flat 0.25% router fee (cheaper than Trojan/Photon/GMGN at 0.5–1%), and a free on-chain scam-check on every token you buy.

You keep custody. The tool returns an unsigned transaction — you sign it with your own key and broadcast. StillOS never touches your funds.

MCP

{
  "mcpServers": {
    "stillos-swap": { "command": "npx", "args": ["-y", "stillos-swap-mcp", "mcp"] }
  }
}
Tools
  • build_solana_swap — { userPublicKey, inputMint, outputMint, amount } → { swapTransaction (base64, unsigned), expectedOut, route, routerFee, safety }. Sign and send the transaction yourself. When buying a non-stablecoin, safety carries an on-chain verdict (CLEAN / TRAP) based on live mint & freeze authority.
  • token_scam_check — { mint } → { verdict (CLEAN/RISK/UNKNOWN), mintAuthority, freezeAuthority, flags }. Established issuer tokens (USDC/USDT/SOL) are allowlisted. Read-only, no keys.

CLI

npx stillos-swap-mcp check <mint>
npx stillos-swap-mcp swap <yourPubkey> SOL USDC 0.5

Why the scam-check matters

A live mint authority means the dev can print unlimited supply and dilute you to zero. A live freeze authority means the dev can freeze your tokens so you can never sell. Both are the most common rug vectors on pump.fun. This checks them before you buy — free.

SOLANA_RPC env var overrides the default public RPC for the safety check.

MIT · StillOS / NolaWealth

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.