dex-skills v0.1.0

Claude Code

Claude Code natively supports MCP servers. By registering dex-skills as an MCP server, you can query token data, check trending tokens, launch tokens, and trade -- all through natural language in your terminal.

Setup

Add dex-skills to your Claude Code MCP configuration. You can configure it at the project level or globally.

Option 1: Project-level (recommended)

Create or edit .mcp.json in your project root:

.mcp.json
{
  "mcpServers": {
    "dex-skills": {
      "command": "npx",
      "args": ["dex-skills", "--mcp"],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
        "BASE_RPC_URL": "https://mainnet.base.org",
        "BNB_RPC_URL": "https://bsc-dataseed.binance.org",
        "TRON_FULL_HOST": "https://api.trongrid.io"
      }
    }
  }
}

Option 2: Global

Add to ~/.claude/settings.json to make dex-skills available in all projects:

~/.claude/settings.json
{
  "mcpServers": {
    "dex-skills": {
      "command": "npx",
      "args": ["dex-skills", "--mcp"],
      "env": {
        "SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
        "BASE_RPC_URL": "https://mainnet.base.org"
      }
    }
  }
}
Environment variables
Only configure the RPC URLs for the chains you need. For example, if you only work with Solana platforms (Pump.fun, LetsBonk, Moonshot), you only need SOLANA_RPC_URL.

Usage Examples

Once configured, you can interact with dex-skills through natural language in Claude Code.

Read-only queries (no private key needed)

Claude Code prompts
> Show me trending tokens on Pump.fun

> Get token info for So11111111111111111111111111111111111111112 on pumpfun

> List the 10 newest tokens on Zora

> Show trade history for token XYZ on moonshot

Trading (requires private key per request)

Claude Code prompts
> Launch a token called "Test Token" with symbol TEST on Pump.fun

> Buy 0.1 SOL worth of token ABC on pumpfun

> Sell 1000000 tokens of ABC on moonshot
Private key handling
For write operations (launch, buy, sell), Claude Code will prompt you for a private key as a tool parameter. The key is passed directly to the MCP server, used once for transaction signing, and never stored or logged. You will see the tool call details before approving execution.

Available Tools

Once connected, Claude Code can use these 11 tools:

Tool Description Key
dex_platforms List all supported platforms No
dex_get_token Get token info by address No
dex_list_tokens List tokens with sorting/pagination No
dex_trending Get trending tokens by category No
dex_trade_history Get trade history for a token No
dex_holders Get token holders (Zora only) No
dex_estimate_price Price estimate (Four.meme only) No
dex_launch Launch a new token Yes
dex_buy Buy tokens on a platform Yes
dex_sell Sell tokens on a platform Yes

Yes = requires private key per request. No = read-only, no credentials needed.

Verify Connection

After adding the configuration, restart Claude Code and try a simple query to confirm the server is running:

Claude Code
> What DEX platforms are available?

Claude will call the dex_platforms tool and return a list of all 7 supported platforms with their chains.

Troubleshooting

Issue Solution
Tools not showing up Restart Claude Code after editing .mcp.json. Check that npx dex-skills --mcp runs without errors.
RPC errors Verify your RPC URLs are correct and accessible. Use a dedicated RPC provider for production use.
Transaction failures Ensure the private key has sufficient balance for the transaction and gas fees.