Content
# BotIndex MCP Server
> Signal intelligence for AI agents — sports odds, crypto correlations, token graduations, and more. **50 free premium requests per wallet.** Then pay per request with USDC via [x402](https://x402.org). No API keys. Every response carries a cryptographically signed [Agent Action Receipt (AAR)](https://aar.botindex.dev).
**Live API:** [king-backend.fly.dev](https://king-backend.fly.dev/api/botindex/v1/)
---
## Try It Now
```bash
# Run the MCP server
npx botindex-mcp-server
# Or test the API directly (free endpoints)
curl https://king-backend.fly.dev/api/botindex/v1/
curl https://king-backend.fly.dev/api/botindex/zora/trending-coins
curl https://king-backend.fly.dev/api/botindex/hyperliquid/funding-arb
```
---
## Install
```bash
npm install botindex-mcp-server
```
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:
```json
{
"mcpServers": {
"botindex": {
"command": "npx",
"args": ["-y", "botindex-mcp-server"]
}
}
}
```
### Cursor
Add to `.cursor/mcp.json`:
```json
{
"mcpServers": {
"botindex": {
"command": "npx",
"args": ["-y", "botindex-mcp-server"]
}
}
}
```
### Windsurf / Cline / Continue.dev
Same pattern — point your MCP config at `npx botindex-mcp-server`.
---
## 17 Tools
### Sports Intelligence
| Tool | Description | Price |
|------|-------------|-------|
| `botindex_sports_odds` | Live odds across NFL, NBA, UFC, NHL | $0.02 |
| `botindex_sports_lines` | Line movements + sharp action flags | $0.02 |
| `botindex_sports_props` | Player prop bets with confidence | $0.02 |
| `botindex_sports_correlations` | Player correlation matrix for DFS | $0.05 |
| `botindex_sports_optimizer` | Correlation-adjusted DFS lineup optimizer | $0.10 |
| `botindex_sports_arb` | Cross-platform arbitrage scanner | $0.05 |
### Crypto & Token Launches
| Tool | Description | Price |
|------|-------------|-------|
| `botindex_crypto_tokens` | Token universe with price data | $0.02 |
| `botindex_crypto_graduating` | Catapult→Hyperliquid graduation signals | $0.02 |
| `botindex_solana_launches` | Metaplex Genesis token launches | $0.02 |
| `botindex_solana_active` | Active Genesis launches only | $0.02 |
| `botindex_correlation_leaders` | Top correlated/anti-correlated pairs | $0.05 |
### Agentic Commerce
| Tool | Description | Price |
|------|-------------|-------|
| `botindex_commerce_compare` | Compare ACP vs UCP vs x402 protocols | $0.05 |
| `botindex_commerce_protocols` | Protocol directory with fees | $0.01 |
### Premium Analytics
| Tool | Description | Price |
|------|-------------|-------|
| `botindex_dashboard` | Correlation matrix, leaders, fear/greed | $0.50 |
| `botindex_signals` | Aggregated prediction market signals | $0.10 |
| `botindex_agent_trace` | Agent reasoning trace | $0.05 |
| `botindex_discover` | Full endpoint catalog (FREE) | Free |
---
## How Payment Works
BotIndex uses [x402](https://github.com/coinbase/x402) — the HTTP 402 Payment Required protocol by Coinbase.
```
Your Agent → calls botindex tool
MCP Server → GET king-backend.fly.dev/api/botindex/v1/sports/odds
← 402 + payment instructions (amount, wallet, network)
→ pays USDC on Base via x402
← 200 + data
```
No API keys. No signup. No rate limit tiers. Your wallet is your identity.
### Free Trial
Every wallet gets **50 free premium requests**. Just send an `X-Wallet: 0x...` header. The response includes `X-BotIndex-Free-Remaining` so you know exactly where you stand. After 50 requests, x402 payment kicks in automatically.
To enable automatic payments after trial, configure your agent with a funded Base wallet and the [@x402/client](https://www.npmjs.com/package/@x402/client) SDK.
---
## Free Endpoints (No Payment)
These work out of the box — no wallet needed:
- `botindex_discover` — full endpoint catalog with pricing
- Zora trending coins (via API: `/api/botindex/zora/trending-coins`)
- Hyperliquid funding arb (via API: `/api/botindex/hyperliquid/funding-arb`)
---
## Free vs Pro
- **Free key:** 100 requests/day on free endpoints. Premium endpoints return an upgrade/payment prompt.
- **Pro key ($29/mo):** Unlimited access to all endpoints with no x402 payment gates.
Upgrade link: https://api.botindex.dev/api/botindex/keys/register?plan=pro
---
## Verifiable Agent Actions (AAR)
Every BotIndex API response carries a signed **Agent Action Receipt** in the `X-AAR-Receipt` header — Ed25519-signed proof of what your agent requested, what was returned, and what it cost.
- **Verify any receipt independently** — no trusted intermediary needed
- **Privacy-preserving** — inputs/outputs are SHA-256 hashed, not exposed
- **Compatible with [Mastercard Verifiable Intent](https://www.mastercard.com/us/en/news-and-trends/stories/2026/verifiable-intent.html)** — bidirectional mapping
- **Aztec ZK-compatible** — verify on-chain without revealing contents
```bash
npm install botindex-aar
```
```ts
import { verifyReceipt } from 'botindex-aar';
const result = verifyReceipt(receipt);
// { ok: true } — receipt is valid and untampered
```
- **AAR Spec:** [github.com/Cyberweasel777/agent-action-receipt-spec](https://github.com/Cyberweasel777/agent-action-receipt-spec)
- **Landing:** [aar.botindex.dev](https://aar.botindex.dev)
- **npm:** [botindex-aar](https://www.npmjs.com/package/botindex-aar)
---
## Links
- **API:** [king-backend.fly.dev/api/botindex/v1/](https://king-backend.fly.dev/api/botindex/v1/)
- **Agent Discovery:** [/.well-known/ai-plugin.json](https://king-backend.fly.dev/.well-known/ai-plugin.json)
- **AAR Trust Layer:** [aar.botindex.dev](https://aar.botindex.dev)
- **x402 Protocol:** [github.com/coinbase/x402](https://github.com/coinbase/x402)
- **Source:** [github.com/Cyberweasel777/king-backend](https://github.com/Cyberweasel777/king-backend)
---
## License
MIT
