io.github.Cyberweasel777/botindex-mcp-server

Official registry Finance and payments

DeFi signal intelligence + agent discovery. Funding arb, whale alerts, Zora, compliance.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package botindex-mcp-server
Claude Code
claude mcp add botindex-mcp-server -e 'BOTINDEX_BASE_URL=<BOTINDEX_BASE_URL>' -- npx -y botindex-mcp-server@2.2.0
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "botindex-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "botindex-mcp-server@2.2.0"
            ],
            "env": {
                "BOTINDEX_BASE_URL": "<BOTINDEX_BASE_URL>"
            }
        }
    }
}

Environment variables

  • BOTINDEX_BASE_URL Base URL for BotIndex API (optional, defaults to https://api.botindex.dev)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. BotIndex MCP Server
  2. Try It Now
  3. Install
  4. 17 Tools
  5. How Payment Works
  6. Free Endpoints (No Payment)
  7. Free vs Pro
  8. Verifiable Agent Actions (AAR)
  9. Links
  10. License

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
ToolDescriptionPrice
botindex_sports_oddsLive odds across NFL, NBA, UFC, NHL$0.02
botindex_sports_linesLine movements + sharp action flags$0.02
botindex_sports_propsPlayer prop bets with confidence$0.02
botindex_sports_correlationsPlayer correlation matrix for DFS$0.05
botindex_sports_optimizerCorrelation-adjusted DFS lineup optimizer$0.10
botindex_sports_arbCross-platform arbitrage scanner$0.05
Crypto & Token Launches
ToolDescriptionPrice
botindex_crypto_tokensToken universe with price data$0.02
botindex_crypto_graduatingCatapult→Hyperliquid graduation signals$0.02
botindex_solana_launchesMetaplex Genesis token launches$0.02
botindex_solana_activeActive Genesis launches only$0.02
botindex_correlation_leadersTop correlated/anti-correlated pairs$0.05
Agentic Commerce
ToolDescriptionPrice
botindex_commerce_compareCompare ACP vs UCP vs x402 protocols$0.05
botindex_commerce_protocolsProtocol directory with fees$0.01
Premium Analytics
ToolDescriptionPrice
botindex_dashboardCorrelation matrix, leaders, fear/greed$0.50
botindex_signalsAggregated prediction market signals$0.10
botindex_agent_traceAgent reasoning trace$0.05
botindex_discoverFull 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


License

MIT

Frequently asked questions

What is io.github.Cyberweasel777/botindex-mcp-server?

DeFi signal intelligence + agent discovery. Funding arb, whale alerts, Zora, compliance.

How do I install io.github.Cyberweasel777/botindex-mcp-server?

It runs on your machine. In Claude Code: claude mcp add botindex-mcp-server -e 'BOTINDEX_BASE_URL=<BOTINDEX_BASE_URL>' -- npx -y botindex-mcp-server@2.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.Cyberweasel777/botindex-mcp-server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.Cyberweasel777/botindex-mcp-server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.Cyberweasel777/botindex-mcp-server?

It is published by Cyberweasel777. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.