Prerequisites
You need a Shoot API key. Keys are bound to a Solana wallet and created via the/api/agent/keys endpoint. See Agent API for the full key creation flow.
Once you have a key it looks like: shoot_ak_T3cm6zZhEUUgsLdQv...
Installation
- Claude Code
- Claude Desktop
- Cursor
- Local Dev
Create a Claude Code picks this up automatically — no restart required.Verify it’s connected:You should see
.mcp.json file in your project root (or home directory for global):shoot-trading listed as a connected server with 12 tools.Available Tools
All 12 tools are exposed. The wallet is bound to your API key — you don’t pass it as a parameter.Read Tools (60 req/min)
| Tool | Description |
|---|---|
getPositions | Open and historical positions for your wallet |
getPoolStats | Adrena pool volume, fees, TVL |
getLiquidityInfo | Per-custody liquidity: TVL, utilization, target ratios |
getLeaderboard | Competition standings by cohort ID |
getActiveCohorts | Live and upcoming competitions |
getMyEnrollments | Competitions your wallet is enrolled in |
Trading Tools (10 req/min)
Trading tools return unsigned Solana transactions — your agent receives a base64-encodedVersionedTransaction that must be signed and submitted separately. The server never holds private keys.
| Tool | Description |
|---|---|
openLong | Open leveraged long (BONK, JITOSOL, WBTC) |
openShort | Open leveraged short |
closeLong | Close long (full or partial) |
closeShort | Close short (full or partial) |
openLimitLong | Limit order for long |
openLimitShort | Limit order for short |
Supported asset symbols:
BONK, JITOSOL, WBTC. Collateral: USDC.
Using BTC or SOL as the asset returns ASSET_TOKEN_NOT_FOUND.How Signing Works
The MCP server returns an unsigned transaction. Your agent handles signing:Example Agent Prompt
Once the MCP server is connected, you can ask your agent directly:getPoolStats, getLiquidityInfo, then openLong — all via MCP.
Related
Agent API
REST API alternative — HTTP execute and chat endpoints
Claude Code Skill
Drop-in skill for full context: signing flow, lifecycle, Surfpool testing