Kerdos X402 Mcp

io.github.Singlishman由 GitHub 帳號 Singlishman 發布v0.1.0更新於 Oct 24, 2026

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

已驗證STDIO僅桌面金融資料與分析

概覽

AI 產生的概覽

為助理提供 11 個加密貨幣市場情報工具，每次呼叫透過 Base 上的 x402 協議以 USDC 付費。

可以做什麼
將 Kerdos 市場情報 API 包裝成工具，涵蓋市場總覽、情緒、牛熊狀態、永續資金費率、黃金訊號、巨鯨警示、清算、累計成交量差、連鎖風險、資金費率混亂度，以及打包的綜合訊號。每次呼叫都透過 x402 付款流程在 Base 主網上以 USDC 計費，單次價格從 0.01 到 0.06 美元。回傳 JSON 格式的市場資料，耗時約一到兩秒。
適用情境
適合助理需要隨選取得加密貨幣市場訊號來做交易分析，且不想註冊 API 金鑰或訂閱服務的情境。適用於已在 Base 上持有 USDC、並接受逐次付費的代理。
執行需求
透過 stdio 在本機執行，可用 npm 全域安裝或透過 npx 執行，因此需要 Node.js。需要 EVM_PRIVATE_KEY 環境變數，存放 Base 主網上的 EVM 私鑰，並需要連線至 Kerdos x402 端點的網路。選用變數 KERDOS_X402_BASE_URL 可覆寫端點基礎網址。僅支援桌面端，沒有網頁版。
安裝前請注意
EVM_PRIVATE_KEY 是完整的 EVM 私鑰，用來簽署 USDC transferWithAuthorization 付款；持有者可動用該錢包資金，建議使用專用的低餘額錢包。每次工具呼叫都會花費 0.01 至 0.06 USDC，且沒有互動式確認，費用會默默累積。請求和付款授權會傳送到第三方端點，選用的基礎網址覆寫指向一個 ngrok 主機。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Kerdos X402 Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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.

來源：README.md，提交 694cbf1

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分