{"version":"0.1.0","name":"Bloodhound MCP","description":"Pump.fun + PumpSwap analytics for AI trading agents on Solana. Per-mint trade facts, smart-money signals, cluster detection, priced in USDC via x402.","transports":[{"kind":"http_rest","base":"/v1","auth":"x402_usdc_solana","note":"Production. Use x402-fetch in JS/TS or any x402 client."},{"kind":"mcp_stdio","auth":"none","note":"Local development only — Claude Desktop / Cursor / Claude Code."}],"facilitator":{"url":"https://api.cdp.coinbase.com/platform/v2/x402","network":"solana","receiver":"HTvdg5d34iCrzVf1PwMi42GSkS53Z5L384F2gyVTXjY3","note":"CDP-authenticated mainnet. Buyer needs USDC at their ATA; SOL gas is sponsored."},"pricing":{"model":"per_call_or_session","per_call_tiers":{"t02":"$0.02","t05":"$0.05","t10":"$0.10","t15":"$0.15","t25":"$0.25"},"free_tools":["static_addresses"],"session_passes":[{"tier":"pass_5","price":"$5.00","calls":200,"duration":"1 hour","effective_per_call_usd":0.025},{"tier":"pass_25","price":"$25.00","calls":1000,"duration":"24 hours","effective_per_call_usd":0.025}]},"error_reasons":[{"http":402,"reason":"unknown","source":"session","meaning":"Session header missing, malformed, or never minted.","fix":"POST /v1/session/buy/pass_5 (or pass_25) to obtain a fresh session_id."},{"http":402,"reason":"expired","source":"session","meaning":"Session is past its expires_at.","fix":"Buy a fresh session."},{"http":402,"reason":"exhausted","source":"session","meaning":"Session calls_remaining hit 0.","fix":"Buy a fresh session, or upgrade pass tier."},{"http":402,"reason":"invalid_payload","source":"x402_facilitator","meaning":"Facilitator rejected the signed payment (most often: stale blockhash).","fix":"Make sure the buyer-side RPC is fresh — pass svmConfig.rpcUrl pointing at a paid Helius/QuickNode URL."},{"http":402,"reason":"insufficient_funds","source":"x402_facilitator","meaning":"Buyer USDC ATA balance below the required price.","fix":"Top up the buyer wallet."},{"http":400,"reason":"invalid input","source":"tool","meaning":"Zod schema rejected the args.","fix":"Check the tool input schema in /v1/tools (or MCP tools/list)."},{"http":404,"reason":"unknown tool","source":"router","meaning":"Tool name not in registry.","fix":"GET /v1/tools for the catalog."}],"recipes":[{"name":"Snipe a hot launch","pattern":"discover -> blueprint -> SDK","tools":["trending_tokens","get_trade_blueprint"],"cost_per_run_usd":{"per_call":0.3,"on_pass_5":0.05},"note":"get_trade_blueprint returns every fact @pump-fun/pump-sdk needs in one call (saves 4 RPCs)."},{"name":"Find a wallet to copytrade","pattern":"top -> verify -> filter","tools":["top_tokens_by_smart_money","wallet_overview","wallet_pnl_timeseries","wallet_recent_trades","bot_deployer_pattern"],"cost_per_run_usd":{"per_call":0.45,"on_pass_5":0.13},"note":"Replaces 3-5 days of Solscan + CSV grind."},{"name":"Audit a token before buying","pattern":"overview -> rug-score -> first-buyers -> clusters","tools":["token_overview","token_rug_score","token_first_buyers","token_bundle_clusters"],"cost_per_run_usd":{"per_call":0.5,"on_pass_5":0.1}}],"docs":{"AGENTS_md":"https://bloodhound.so/AGENTS.md","landing":"https://bloodhound.so","tool_catalog":"/v1/tools","health":"/healthz","public_stats":"/v1/public/stats"}}