supah-mcp

Multi-chain intelligence oracle for AI agents. 20+ tools across 21 EVM blockchains — token safety, price data, wallet analytics, whale tracking, DeFi positions, NFT intelligence, and live trading signals.

Payments via x402 USDC micropayments on Base mainnet. No API keys. Just pay-per-call.

npx supah-mcp

Supported Chains

Every tool marked 🌐 below works on all of these chains. Pass chain: "eth" for Ethereum, chain: "bsc" for BNB Chain, etc. Default is always base when no chain is specified.

| Chain | Name | Moralis | GoPlus | Chain ID | |-------|------|:-------:|:------:|----------| | eth | Ethereum | ✅ | ✅ | 1 | | base | Base | ✅ | ✅ | 8453 | | polygon | Polygon | ✅ | ✅ | 137 | | bsc | BNB Chain | ✅ | ✅ | 56 | | arbitrum | Arbitrum One | ✅ | ✅ | 42161 | | optimism | Optimism | ✅ | ✅ | 10 | | avalanche | Avalanche C-Chain | ✅ | ✅ | 43114 | | linea | Linea | ✅ | ✅ | 59144 | | fantom | Fantom | ✅ | — | 250 | | cronos | Cronos | ✅ | ✅ | 25 | | gnosis | Gnosis Chain | ✅ | ✅ | 100 | | moonbeam | Moonbeam | ✅ | — | 1284 | | moonriver | Moonriver | ✅ | — | 1285 | | ronin | Ronin | ✅ | — | 2020 | | lisk | Lisk | ✅ | — | 1135 | | pulse | PulseChain | ✅ | — | 369 | | flow | Flow EVM | ✅ | — | 747 | | blast | Blast | — | ✅ | 81457 | | scroll | Scroll | — | ✅ | 534352 | | zksync | zkSync Era | — | ✅ | 324 | | mantle | Mantle | — | ✅ | 5000 | | celo | Celo | — | — | 42220 |

How it works:

• Token data (price, metadata, holders, transfers, swaps, analytics) → powered by Moralis — works on all Moralis-supported chains
• Safety scans (honeypot detection, risk flags, sell simulation) → powered by GoPlus — works on all GoPlus-supported chains
• Full scans combine both — best coverage on chains supported by both providers
• Chains with only one provider still work — you just get data from the available source

Tip: For maximum coverage, use chains that have both ✅ marks (Ethereum, Base, Polygon, BSC, Arbitrum, Optimism, Avalanche, Linea, Cronos, Gnosis).

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "supah": {
      "command": "npx",
      "args": ["supah-mcp"]
    }
  }
}

OpenClaw / Cursor / Windsurf / Any MCP Client

{
  "command": "npx",
  "args": ["supah-mcp"]
}

Custom API URL

SUPAH_API_URL=https://api.supah.ai npx supah-mcp

Tools

🌐 Multi-Chain Tools

These work on all 21+ supported chains. Pass chain to target a specific network.

Token Intelligence

| Tool | Price | Description | |------|-------|-------------| | supah_token_price | $0.001 | Current price, 24h change, volume, market cap, liquidity | | supah_token_metadata | $0.001 | Name, symbol, total supply, deployer address | | supah_token_pairs | $0.001 | DEX trading pairs with liquidity and reserves | | supah_trending_tokens | $0.001 | Top trending tokens with safety scores | | supah_token_safety | $0.01 | Safety score (0-100), risk flags, honeypot check, sell tax | | supah_token_holders | $0.005 | Top 20 holders, Gini coefficient, whale concentration | | supah_token_transfers | $0.005 | Recent ERC20 token transfers | | supah_token_swaps | $0.005 | Recent DEX swaps with price and volume | | supah_whale_moves | $0.005 | Large transactions for a token | | supah_token_analytics | $0.02 | Full analytics: trends, volume history, holder growth | | supah_full_scan | $0.03 | Complete scan: safety + deployer + liquidity + holders |

Wallet Intelligence

| Tool | Price | Description | |------|-------|-------------| | supah_wallet_approvals | $0.005 | All token approvals — find revoke-worthy risks | | supah_wallet_history | $0.005 | Decoded transaction history with categories | | supah_wallet_net_worth | $0.005 | Total portfolio value and token breakdown | | supah_wallet_portfolio | $0.03 | Full holdings with safety scores per token | | supah_wallet_pnl | $0.02 | Realized/unrealized PnL, win rate, total trades | | supah_wallet_defi | $0.02 | DeFi positions: LPs, lending, staking with protocol info |

🔵 Base-Only Tools

These use SUPAH's proprietary pipeline data — exclusively on Base.

| Tool | Price | Description | |------|-------|-------------| | supah_live_signals | $0.05 | Latest buy/sell signals from SUPAH's trading pipeline | | supah_signal_history | $0.01 | Historical signals with actual PnL outcomes | | supah_token_discovery | $0.03 | New token discovery with enrichment and scoring |

Examples

Check token safety on Ethereum

{
  "tool": "supah_token_safety",
  "arguments": {
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
    "chain": "eth"
  }
}

Get wallet PnL on Arbitrum

{
  "tool": "supah_wallet_pnl",
  "arguments": {
    "wallet": "0x1234...abcd",
    "chain": "arbitrum"
  }
}

Full scan on Base (default)

{
  "tool": "supah_full_scan",
  "arguments": {
    "address": "0xabcd...1234"
  }
}

Scan any chain by name

{
  "tool": "supah_token_price",
  "arguments": {
    "address": "0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82",
    "chain": "bsc"
  }
}

Payment

All paid endpoints use the x402 protocol. When your agent calls a paid endpoint:

1. API returns HTTP 402 with payment details
2. Your x402-compatible client sends USDC on Base
3. API returns the data

No API keys. No subscriptions. Just micropayments.

Prices range from $0.001 (quick data) to $0.05 (premium signals). Average cost per research session: ~$0.10.

Free Demo Endpoints

Test before you pay — free demo endpoints available at the live API:

GET https://api.supah.ai/agent/v1/demo/safety/{address}?chain=eth
GET https://api.supah.ai/agent/v1/demo/price/{address}
GET https://api.supah.ai/agent/v1/demo/trending
GET https://api.supah.ai/agent/v1/demo/signals
GET https://api.supah.ai/agent/v1/demo/token/search?query=pepe&chain=bsc
GET https://api.supah.ai/agent/v1/demo/nft/trending?chain=polygon
GET https://api.supah.ai/agent/v1/demo/block/1?chain=arbitrum
GET https://api.supah.ai/agent/v1/demo/resolve/ens/vitalik.eth

50 free calls/day, 7-day trial period.

Discovery

AI agents and platforms can discover SUPAH via standard protocols:

| Protocol | URL | |----------|-----| | OpenAPI 3.1 | https://api.supah.ai/openapi.json | | x402 Manifest | https://api.supah.ai/.well-known/x402-manifest.json | | AI Plugin | https://api.supah.ai/.well-known/ai-plugin.json | | Agent Registry | https://api.supah.ai/agents.json | | MCP (this package) | npx supah-mcp |

Links

• API Docs & Dashboard: https://api.supah.ai
• Website: https://supah.ai
• Telegram: https://t.me/SUPAH_Based
• X/Twitter: https://x.com/supah_based
• npm: https://www.npmjs.com/package/supah-mcp

License

MIT