# Cyberweasel777/botindex-mcp-server [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/Cyberweasel777/botindex-mcp-server  
**GitHub Stars:** 1  
**npm Downloads (last month):** 315  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/cyberweasel777-botindex-mcp-server

## Description
BotIndex + Agorion MCP server — AI signal intelligence API + agent service discovery network. x402 payment gating on premium endpoints.

## Tools
Capabilities this server exposes over MCP:

- **botindex_discover** — Get the full BotIndex API catalog — all endpoints, pricing, descriptions. FREE.
- **botindex_sports_odds** — Live sports odds snapshot (NFL, NBA, UFC, NHL). Moneyline, spread, totals with bookmaker comparisons. $0.02
- **botindex_sports_lines** — Line movements with sharp money action flags. Identifies professional bettor market impact. $0.02
- **botindex_sports_props** — Top prop bet movements with confidence scores. Player prop market value signals. $0.02
- **botindex_sports_correlations** — Player correlation matrix for DFS and correlated betting. Shows co-performance patterns. $0.05
- **botindex_dfs_optimizer** — Correlation-adjusted DFS lineup optimizer. Returns optimized lineups accounting for player correlations. $0.10
- **botindex_arb_scanner** — Cross-platform prediction market and sportsbook arbitrage scanner. $0.05
- **botindex_crypto_tokens** — Token universe with latest price data from MemeRadar correlation engine. $0.02
- **botindex_crypto_graduating** — Token graduation signals from Catapult launchpad to Hyperliquid mainnet via GradSniper. $0.02
- **botindex_solana_launches** — All tracked Metaplex Genesis token launches on Solana mainnet. $0.02
- **botindex_solana_active** — Currently active Metaplex Genesis launches on Solana (filtered by status). $0.02
- **botindex_commerce_compare** — Compare merchant offers across agentic commerce protocols (ACP, UCP, x402). Ranked offers with trust scores, fees, checkout protocol details. Use before any purchase. $0.05
- **botindex_commerce_protocols** — Directory of agentic commerce protocols — ACP (OpenAI+Stripe), UCP (Google), x402 (Coinbase) with fee structures and merchant counts. $0.01
- **botindex_signals** — Aggregated premium signals: correlation leaders + prediction arbitrage + market heatmap. $0.10
- **botindex_agent_trace** — Premium reasoning trace for a specific agent. $0.05
- **botindex_dashboard** — Full premium dashboard — all agents, traces, correlation matrices, prediction arb, heatmaps. Most comprehensive single-call data package. $0.50
- **botindex_zora_trending_coins** — Get trending Zora attention market coins by volume velocity. Tracks which coins are gaining attention momentum on Zora. $0.03
- **botindex_zora_creator_scores** — Get creator performance scores on Zora. Identifies top-performing creators by attention metrics and coin success rates. $0.03
- **botindex_zora_attention_momentum** — Get attention momentum — which Zora trends are accelerating. Early signal for emerging attention markets before they peak. $0.03
- **botindex_hl_funding_arb** — Get funding rate arbitrage opportunities between Hyperliquid and major CEXs. Identifies cross-exchange funding rate discrepancies for delta-neutral yield. $0.05
- **botindex_hl_correlation_matrix** — Get Hyperliquid perpetual correlation matrix. Shows price correlation between perp pairs for portfolio construction and risk management. $0.05
- **botindex_hl_liquidation_heatmap** — Get liquidation cluster heatmap by price level. Visualizes where liquidations cluster to predict support/resistance zones and volatility spikes. $0.05
- **botindex_hl_coin_analytics** — Get deep analytics for a specific Hyperliquid coin. Comprehensive metrics including OI, funding, volume, and liquidation history. $0.05

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation & README

# 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