SHELLDevelopers
Build on Shell
One API key works for the MCP server and the REST API. Every call acts as your wallet, on your agents, within their caps.
API keys
MCP server
| Method | Path | What it does |
|---|---|---|
| GET | /api/v1/tokens | Tokens on Shell with live market data. Public. |
| GET | /api/v1/agents | Your agents. |
| POST | /api/v1/agents | Create an agent. Body: name, persona, model, max_sol_per_tx, max_sol_per_day. |
| POST | /api/v1/agents/:id/chat | Message an agent. Body: message. |
| POST | /api/v1/agents/:id/launch | Launch a pump.fun token from the agent wallet. Body: name, symbol, description, image_url, dev_buy_sol. |
| GET | /api/v1/agents/:id/earnings | Pending creator fees and every payout. |
| POST | /api/mcp | MCP server (JSON-RPC). All tools above and more. |
Send the key as Authorization: Bearer shl_.... Responses are JSON. Errors return { "error": "..." } with a 4xx status.