MCP.Market

Kerdos X402 MCP server

by Singlishman·io.github.Singlishman/kerdos-x402-mcp·v0.1.0
No reviews yet

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

C69/100grade C
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
C69/100

full report

Adoption
New

0 stars33 downloads/wk

Reviews

Write one

Nobody has reviewed Kerdos X402 yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Kerdos X402 tools (11)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_cascade_risk

    [$0.02] Decision-ready cascade-risk classifier per coin (NONE / LOW / MODERATE / ELEVATED / HIGH) with recommended position-size discount and entry-threshold boost.

  • get_composite_signal

    [$0.06] Bundled market-state inference — combines BTC/ETH regime direction, liquidation cascade risk + OI velocity, and composite sentiment in a single call. Discounted vs the a-la-carte total.

  • get_cvd

    [$0.02] Cumulative Volume Delta — taker buy vs sell volume divergence on BTC/ETH (1h, 4h windows). Detects bullish accumulation and bearish exhaustion.

  • get_funding

    [$0.01] Hyperliquid perpetual funding rates and open interest snapshot for BTC/ETH. For funding-arb screening or crowding detection.

  • get_funding_chaos

    [$0.03] Funding chaos index — counts sub-12h funding-rate sign flips for BTC/ETH/SOL on Hyperliquid. Returns chaos level, per-asset flips, cycle counts, and implied bias (LONG_EXHAUSTION / SHORT_EXHAUSTION / MIXED / NEUTRAL).

  • get_gold_signal

    [$0.03] Gold (XAU) trading signal: direction, confidence, RSI(14), 4h fib retracement context. Sourced from Hyperliquid HIP-3 gold perp.

  • get_liquidations

    [$0.02] Open interest velocity (5m/1h/24h), liquidation cascade risk per coin, and large-trade ($50K+) tracking on Hyperliquid for BTC/ETH/SOL.

  • get_market_overview

    [$0.01] One-call snapshot bundle: BTC/ETH/SOL/GOLD prices, RSI-14, EMA regime direction, Hyperliquid funding rates, open interest, Fear & Greed index. Best first call when an agent needs a per-tick decision context.

  • get_regime

    [$0.02] BTC/ETH market trend direction (bull/bear regime) from EMA50 1h with composite confidence score.

  • get_sentiment

    [$0.05] Composite multi-analyst crypto sentiment with short-term + long-term direction, strength, and contrarian indicator. Curated signal/noise separation.

  • get_whale_alerts

    [$0.01] On-chain whale wallet stance and capital-flow direction. Tracks bridge activity for high-net-worth crypto wallets.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 153 days ago8/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 69/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Kerdos X402 compares

Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
69/100
higher than 38% of 1,761 Finance servers
Tools
11
the typical Finance server has 8
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
33
more than 23% of 421 Finance servers with a package

What its tools let an agent do: 11 read

Install Kerdos X402 in Claude Code, Cursor or VS Code

Runs npx -y kerdos-x402-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add kerdos-x402-mcp -- npx -y kerdos-x402-mcp
Add to Cursor

What the publisher says

From the Kerdos X402 repository's README, as published. We do not edit it. Read it on GitHub

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:

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 claudedesktopconfig.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. getmarketoverview).
  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.

Nothing above is checked by us. What we check is on the safety report.

Kerdos X402: common questions

Is Kerdos X402 MCP server safe?
With care: it is graded C, so read the findings first (69/100). Read the Kerdos X402 safety report
How do I install Kerdos X402?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Kerdos X402 need an API key?
Yes. The registry entry asks for EVM_PRIVATE_KEY.
Is Kerdos X402 maintained?
The last commit was 191 days ago (2026-04-27). The latest release is v0.1.0.
What can I use instead of Kerdos X402?
Servers from other publishers that do the same job: Blockrun MCP server, Agent402.Tools: pay-per-call web tools MCP server and three.ws Agent Payments MCP server.
How does Kerdos X402 compare with other Finance MCP servers?
safety score 69/100 (higher than 38% of 1,761 Finance servers); tools 11 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Kerdos X402

Same job from other publishers: the closest match first, then the best rated.

  • Blockrun
    Web search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.
    B
  • Agent402.Tools: pay-per-call web tools
    Agentic Finance: 500+ agent tools, multi-chain USDC over x402 or MPP, or free via proof-of-work
    A
  • three.ws Agent Payments
    Governed x402 payment sessions: pay any endpoint with budget, allowlist & per-tx caps, no key.
    More from nirholas →
    B
  • Hive Intelligence MCP
    Evidence-backed crypto due diligence with sources, freshness, and a runtime receipt on every call.
    C
  • Shumi
    Crypto market intelligence: prices, funding rates, narratives, regime, and delta-neutral research.
    A