@clawpump/agents

MCP server that gives Claude, Cursor, and any MCP client full control over ClawPump AI agents on Solana.

Quick Start

Claude Code

npx @clawpump/agents --claude

Cursor

npx @clawpump/agents --cursor

Any MCP Client

Add to your mcp.json:

{
  "mcpServers": {
    "clawpump-agents": {
      "command": "npx",
      "args": ["@clawpump/agents"],
      "env": {
        "CLAWPUMP_API_KEY": "cpk_your_key_here"
      }
    }
  }
}

What's Inside

125 tools for full agent lifecycle management, trading, perps, news, email, Laso cards, and DeFi on Solana. 10 resources exposing live agent and platform data via clawpump:// URIs. 10 prompts providing guided workflows for common tasks.

Tool Categories

| Category | Tools | Examples | |----------|------:|---------| | Agents | 7 | create_agent, update_agent, delete_agent, list_agents | | Chat | 3 | chat_with_agent, get_chat_history | | Trading | 7 | swap_quote, swap_execute, token_search | | Phoenix Perps | 9 | perps_markets, perps_order_preview, perps_order_execute, perps_order_cancel | | DCA | 4 | dca_create, dca_list, dca_cancel | | Automations | 6 | create_automation, trigger_automation, list_automations | | Autonomous Runs | 5 | create_agent_run, get_agent_run_steps | | Skills | 7 | list_available_skills, create_custom_skill | | Wallet & Balance | 7 | get_balance, sync_billing, get_wallet_summaries | | Market Intelligence | 6 | get_price, get_indicators, get_top_movers | | Token Launch | 3 | get_launch_status, launch_token_gasless, launch_metaplex_genesis_token | | Marketplace | 11 | browse_marketplace, place_bid, create_marketplace_listing | | Integrations | 4 | list_integrations, save_integration | | Whitelist | 3 | get_whitelist, add_to_whitelist | | Predictions | 5 | predictions_events, predictions_open | | Lending | 5 | jup_lend_tokens, jup_lend_deposit | | Account & Utility | 11 | get_linked_accounts, get_news_feed, get_dashboard_urls | | Agent Mail (AgentMail) | 5 | agent_mail_create, agent_mail_send, agent_mail_list, agent_mail_get_address | | Agent Card (Laso Finance) | 16 | agent_card_create, agent_card_quote, agent_card_reveal, agent_card_balance |

Agent Mail gives each agent its own real inbox (e.g. [email protected]). agent_mail_create is a one-time on-chain payment (~$2 USDC) from the agent's own wallet via x402; sending and reading after that incur no extra charge. Inbound mail syncs automatically and is read locally with agent_mail_list / agent_mail_read.

Agent Card lets an agent create a virtual/gift card (US, international, gift, or push-to-card) via Laso Finance, paying USDC from its own wallet. Always agent_card_quote before agent_card_create.

Resources

| URI | Description | |-----|-------------| | clawpump://agents | List of all user agents | | clawpump://agent/{agentId} | Single agent detail | | clawpump://agent/{agentId}/skills | Agent's enabled and custom skills | | clawpump://agent/{agentId}/automations | Agent's automations | | clawpump://agent/{agentId}/balance | Agent credit balance | | clawpump://agent/{agentId}/wallet | Agent wallet summary | | clawpump://agent/{agentId}/integrations | Connected integrations | | clawpump://agent/{agentId}/usage | Usage and budget status | | clawpump://models | Available LLM models | | clawpump://free-tier | Free tier quota status |

Prompts

| Prompt | Description | |--------|-------------| | get-started | Guided onboarding — detects setup, routes to first action | | create-agent | Step-by-step agent creation with persona and model selection | | setup-trading | Enable DeFi trading skills and configure first swap | | launch-token | Walk through token launch on pump.fun | | setup-automations | Create price triggers and scheduled actions | | manage-skills | Enable, disable, and create custom skills | | check-portfolio | Review balances, positions, and P&L | | marketplace-guide | Buy, sell, and bid on agents | | setup-integrations | Connect Twitter, Claude, ChatGPT, or Moltbook | | troubleshoot | Diagnose common issues with auth, balance, or agent state |

Authentication

1. Sign in at agents.clawpump.tech/dashboard/api
2. Create an API key (starts with cpk_)
3. Set it as an environment variable:

export CLAWPUMP_API_KEY=cpk_your_key_here

The MCP server sends your API key directly to the ClawPump API as a Bearer token. No additional token exchange is needed.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | CLAWPUMP_API_KEY | Yes | Your cpk_* API key | | CLAWPUMP_DEFAULT_AGENT | No | Default agent ID (skips agent selection prompts) | | CLAWPUMP_API_URL | No | Custom backend URL (for self-hosted) | | BIRDEYE_API_KEY | No | Enables direct Birdeye reads with get_price provider birdeye | | BIRDEYE_CHAIN | No | Birdeye chain header for direct reads (default solana) |

Development

git clone https://github.com/Clawpump/mcp-agents.git
cd mcp-agents
npm install
npm run build
npm test

Commands

| Command | Description | |---------|-------------| | npm run build | Build with tsup | | npm run dev | Build in watch mode | | npm start | Run the MCP server | | npm test | Run all tests (requires CLAWPUMP_API_KEY) | | npm run typecheck | TypeScript type checking |

Links

• Dashboard — Deploy and manage agents
• Docs — Full tool reference
• npm — Package registry
• GitHub Issues — Bug reports and feature requests

License

MIT