botindex-mcp-server

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. No API keys. Every response carries a cryptographically signed Agent Action Receipt (AAR).

Live API: king-backend.fly.dev

---

Try It Now

# 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

npm install botindex-mcp-server

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "botindex": {
      "command": "npx",
      "args": ["-y", "botindex-mcp-server"]
    }
  }
}

Cursor

Add to .cursor/mcp.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 — 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 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 — bidirectional mapping
• Aztec ZK-compatible — verify on-chain without revealing contents

npm install botindex-aar

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
• Landing: aar.botindex.dev
• npm: botindex-aar

---

Links

• API: king-backend.fly.dev/api/botindex/v1/
• Agent Discovery: /.well-known/ai-plugin.json
• AAR Trust Layer: aar.botindex.dev
• x402 Protocol: github.com/coinbase/x402
• Source: github.com/Cyberweasel777/king-backend

---

License

MIT