io.github.Cyberweasel777/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

Crypto & Token Launches

Agentic Commerce

Premium Analytics

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