# Bloodhound

> An MCP server that gives AI trading agents real-time pump.fun and PumpSwap
> intelligence plus tx-ready trade blueprints over x402 (USDC-on-Solana). One
> blueprint call replaces ~800ms of pre-trade RPC chatter; the agent hands the
> result straight to `@pump-fun/pump-sdk`.

If you are an autonomous agent integrating Bloodhound, read [AGENTS.md](/AGENTS.md)
first — it is the canonical integration guide (transports, pricing, error
vocabulary, recipes). The JSON endpoints below are self-describing.

## Agent integration

- [AGENTS.md](/AGENTS.md): full integration guide — x402 vs session-pass, pricing tiers, error codes, recipes. Section §1 is a 40-line hello-world you can copy-paste and run in 3 seconds for $0.02.
- [/v1/agents/quickstart](https://bloodhound.so/v1/agents/quickstart): structured manifest (JSON) — transports, facilitator, pricing, error vocabulary, recipes. Designed so an LLM-driven client can wire itself up from this one response.
- [/v1/tools](https://bloodhound.so/v1/tools): full tool catalog (JSON) — 68 tools, each with name, code, description, tier, price, output example, and receiver wallet
- [/healthz](https://bloodhound.so/healthz): liveness + DB ping

## Runnable examples

Drop-in `.mjs` scripts — `curl` down, `npm i x402-fetch bs58`, run with your keypair path. No glue layer to invent.

- [/examples/hello.mjs](https://bloodhound.so/examples/hello.mjs): $0.02, ~3s — proves your signer + x402 wiring works end-to-end
- [/examples/find_snipe_targets.mjs](https://bloodhound.so/examples/find_snipe_targets.mjs): ~$2.05, ~30s — ranks the trending feed by rug-risk + sniper-concentration + curve-progress, prints top 3
- [/examples/find_copytrade_wallet.mjs](https://bloodhound.so/examples/find_copytrade_wallet.mjs): $5 (one pass_5), ~10s — buys a session, fans out 20+ calls, prints wallets with ≥100 SOL PnL + ≥55% win rate + 10/14 green days
- [/examples/](https://bloodhound.so/examples/): index with cost + runtime + answers-what summary

## Convenience redirects

So an agent that fetches the obvious URL lands on JSON, not the React SPA:

- `/tools`  → `/v1/tools`
- `/docs`   → `/AGENTS.md`
- `/agents` → `/AGENTS.md`

## Live data

- [/v1/public/stats](https://bloodhound.so/v1/public/stats): live indexer stats (launches/5m, trades/today, lifetime events). Free, CORS-open, no auth.

## Transports

- **HTTP REST** at `POST https://bloodhound.so/v1/tools/:name` — paid in USDC via x402. Production agents use this.
- **MCP stdio** — for local development with Claude Desktop / Cursor / Claude Code. No paywall (trust boundary is "you ran it on your own laptop"). Same tool registry, same input schemas, same output shapes.

## Pricing modes

- **Per-call**: tiers `t02` ($0.02) → `t25` ($0.25). The headline `get_trade_blueprint` is `t25`. CDP settle ~2.5s end-to-end. Use for occasional one-shots.
- **Session pass**: `pass_5` ($5 / 200 calls / 1h) or `pass_25` ($25 / 1000 calls / 24h). Spend with `X-Session-Id` header — 30-80ms per call, no x402 round-trip. Use for sniping / discovery loops.

## Optional

- [Landing page](https://bloodhound.so): the human-facing site (React SPA — agents will not find content here, hit `/AGENTS.md` or `/v1/tools` instead).