Kerdos X402 Mcp

io.github.SinglishmanPublished by GitHub account Singlishmanv0.1.0Updated Oct 24, 2026

Crypto market intelligence MCP — pay-per-tool-call in USDC on Base via the x402 protocol.

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

AI-generated overview

Gives an assistant 11 crypto market intelligence tools paid per call in USDC on Base via the x402 protocol.

What you can do
Exposes Kerdos Market Intelligence APIs as tools covering market overview, sentiment, bull/bear regime, perpetual funding rates, gold signals, whale alerts, liquidations, cumulative volume delta, cascade risk, funding chaos, and a bundled composite signal. Each call is billed in USDC on Base mainnet through the x402 payment flow, with prices from $0.01 to $0.06 per call. Responses are JSON market data returned in roughly one to two seconds.
When to use it
Useful when an assistant needs on-demand crypto market signals for trading analysis without signing up for an API key or subscription. Suited to agents that already hold USDC on Base and are comfortable paying per tool call.
Requirements
Runs locally over stdio, installed globally with npm or run via npx, so Node.js is needed. Requires the EVM_PRIVATE_KEY environment variable holding an EVM private key on Base mainnet, and network access to the Kerdos x402 endpoint. An optional KERDOS_X402_BASE_URL variable overrides the endpoint base URL. Desktop-only; no web executable.
Before you install
EVM_PRIVATE_KEY is a full EVM private key used to sign USDC transferWithAuthorization payments; anyone with it can move funds from that wallet, so a dedicated low-balance wallet is advisable. Every tool call spends $0.01-$0.06 USDC with no interactive approval, so costs accrue silently. Requests and payment authorizations go to a third-party endpoint, and the optional base URL override points at an ngrok host.

Installation

In SourceWeft

  1. Open Kerdos X402 Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
npm install -g kerdos-x402-mcp

Or run via npx (no install):

bash
npx kerdos-x402-mcp

Required env

bash
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

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

Claude Desktop config

Add to claude_desktop_config.json:

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.

Source: README.md at commit 694cbf1

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts