mcpField
K
kerdos-x402-mcp

kerdos-x402-mcp

Local
github.com/SinglishmanFinance0Updated 27w ago
Repository

About kerdos-x402-mcp

kerdos-x402-mcp exposes Kerdos Market Intelligence data to AI trading agents through an MCP server. Its 11 analysis tools charge per call in USDC on Base using the x402 protocol.

Key features

  1. 0111 crypto market analysis tools
  2. 02Market sentiment and trend signals
  3. 03Funding rates and open interest
  4. 04Whale activity and liquidation risk
  5. 05Per-call USDC payments on Base

Use cases

  1. 01Check BTC, ETH, SOL, and gold market snapshots
  2. 02Monitor perpetual funding rates and open interest
  3. 03Assess whale flows and liquidation risk

MCP support

The MCP server provides Kerdos Market Intelligence tools to AI clients. Each tool call is paid for in USDC on Base through the x402 protocol.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "singlishman-kerdos-x402": {
      "command": "npx",
      "args": [
        "-y",
        "kerdos-x402-mcp"
      ],
      "env": {
        "EVM_PRIVATE_KEY": "<EVM_PRIVATE_KEY>",
        "KERDOS_X402_BASE_URL": "<KERDOS_X402_BASE_URL>"
      }
    }
  }
}
Run commandnpx -y kerdos-x402-mcp
Environment variables to set
EVM_PRIVATE_KEYSecretUser-supplied EVM private key on Base mainnet. Used solely to sign USDC `transferWithAuthorization` payment payloads via x402. Each tool call costs $0.01-$0.06 USDC.
KERDOS_X402_BASE_URLOptional override of the Kerdos x402 endpoint base URL.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmkerdos-x402-mcp0.1.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

kerdos-x402-mcp

MCP server exposing Kerdos Market Intelligence APIs as tools for AI trading agents. Pay-per-call in USDC on Base mainnet via the x402 protocol. No API keys, no subscriptions, no signup.

What it does

11 tools for crypto market intelligence:

ToolPriceWhat it returns
get_market_overview$0.01One-call snapshot: BTC/ETH/SOL/GOLD prices + RSI + regime + funding + Fear & Greed
get_sentiment$0.05Composite multi-analyst sentiment, ST + LT direction, contrarian flag
get_regime$0.02BTC/ETH bull/bear regime (EMA50 1h) with composite confidence
get_funding$0.01Hyperliquid perpetual funding rates + OI for BTC/ETH
get_gold_signal$0.03XAU direction, confidence, RSI, 4h fib (HIP-3 gold perp)
get_whale_alerts$0.01Whale wallet stance + on-chain capital flows
get_liquidations$0.02OI velocity + cascade risk + large-trade ($50K+) tracking
get_cvd$0.02Cumulative Volume Delta — taker buy/sell divergence on BTC/ETH
get_cascade_risk$0.02Decision-ready cascade classifier (NONE/LOW/MODERATE/ELEVATED/HIGH) per coin
get_funding_chaos$0.03Sub-12h funding sign-flip regime index for BTC/ETH/SOL
get_composite_signal$0.06Bundled market state (regime + cascade + sentiment) at a discount

Setup

npm install -g kerdos-x402-mcp

Or run via npx (no install):

npx kerdos-x402-mcp
Required env
EVM_PRIVATE_KEY=0x...   # YOUR private key (used to sign payment authorizations)

The MCP server uses your key only to authorize USDC transfers to the Kerdos receiver wallet on Base. Each tool call costs $0.01–$0.06.

Optional env
KERDOS_X402_BASE_URL=https://nonvisceral-eloisa-mousily.ngrok-free.dev

Claude Desktop config

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "kerdos": {
      "command": "npx",
      "args": ["kerdos-x402-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x..."
      }
    }
  }
}

How payment works

  1. MCP client calls a tool (e.g. get_market_overview).
  2. MCP server requests https://...kerdos.../api/market-overview.
  3. Kerdos server returns 402 Payment Required with a payment challenge.
  4. @x402/fetch signs a USDC transferWithAuthorization using your key.
  5. Server verifies the signature, settles via CDP facilitator on Base, returns the JSON response.

End-to-end latency: ~1-2 seconds per call. No interactive approval — payment happens transparently.

Provider

Kerdos Market Intelligence — autonomous trading agent fleet on Hyperliquid + Base. Same signals power Kerdos's own bots' entry decisions.

  • Discovery: https://nonvisceral-eloisa-mousily.ngrok-free.dev/.well-known/x402
  • CDP Bazaar listing: 11 endpoints
  • 402Index: 12 entries
  • Verified domain (402Index)

License

MIT — fork freely.

Issues

GitHub issues on this repo for MCP-side bugs. For endpoint downtime, check https://nonvisceral-eloisa-mousily.ngrok-free.dev/health.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.