English Français العربية

io.github.forgemeshlabs/kronos-forgemesh-mcp

السجل الرسمي المالية والمدفوعات

Kronos market intelligence with calibrated ranges, audits, and x402 payments on Base.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @forgemeshlabs/kronos-forgemesh-mcp
Claude Code 
claude mcp add kronos-forgemesh-mcp -e 'WALLET_PRIVATE_KEY=<your wallet_private_key>' -- npx -y @forgemeshlabs/kronos-forgemesh-mcp@0.2.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "kronos-forgemesh-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@forgemeshlabs/kronos-forgemesh-mcp@0.2.2"
            ],
            "env": {
                "WALLET_PRIVATE_KEY": "<your wallet_private_key>"
            }
        }
    }
}

متغيرات البيئة

  • WALLET_PRIVATE_KEY إلزامي سري Dedicated low-balance Base wallet private key for x402 USDC payments.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Kronos by ForgeMesh MCP
  2. Build your own Kronos
  3. Tools
  4. Install
  5. Requirements
  6. Claude Code / Desktop

Kronos by ForgeMesh MCP

An MCP stdio server that lets agents purchase structured Kronos market intelligence from https://kronos.forgemesh.io using x402 USDC payments on Base. This is the agent client layer for the third Kronos product origin.

Build your own Kronos

Want to build your own Kronos market-intelligence and paper-trading system instead of calling this one? The Kronos Field Guide is the ebook + coding-agent build package we kept being asked for: two learning paths, 81 explained configuration fields, the documented failures of our own paper setup, and two self-contained briefs you hand to Claude Code, Codex or Cursor. https://forgemesh.io/kronos/field-guide — educational only, not financial advice, no support of any kind.

Tools

ToolPurposePrice
get_kronos_riskRisk state, streaks, and cooldown context$0.02
get_kronos_whale_flowsWhale, exchange, bridge, and stablecoin flows$0.02
get_kronos_signalsCurrent multi-symbol signal context$0.05
get_kronos_historyUp to 168 hours of signal history$0.05
get_kronos_forecastCalibrated 80% range and upside probability$0.05
check_kronos_preflightConditions check before journaling$0.05
audit_kronos_decisionOutcome audit for a prior decision_id$0.07
create_kronos_decisionAuditable market-intelligence journal$0.15
get_kronos_perp_fundingFutures. Live perp funding, mark/index, open interest, crowding (Kraken Futures + Hyperliquid)$0.02
check_kronos_futures_riskFutures. Will this side / leverage / entry survive the calibrated range? Liquidation distance + verdict$0.05
get_kronos_futures_decisionFutures. LONG / SHORT / FLAT with stop and target on the calibrated range, leverage cap, liquidation price, sizing, funding cost$0.15
Kronos Futures (new in 0.2.0)

The three futures tools turn a bearish Kronos signal into a sized short instead of "stay out". Direction comes from the same spot signal; stop and target sit on the conformally calibrated 80% range; leverage is capped so liquidation stays outside twice the stop distance and never exceeds the Kronos risk state (NORMAL 3x, ELEVATED 2x, HIGH 1x, absolute 5x). Funding is read live from Kraken Futures and Hyperliquid. No exchange execution ever happens; the output is market intelligence, not a trade instruction. Leverage multiplies losses and adds liquidation risk.

Install

npx -y @forgemeshlabs/kronos-forgemesh-mcp

The private key stays local and is used only to sign x402 payment authorizations. Use a dedicated low-balance Base wallet; never use a primary wallet. The server allowlists https://kronos.forgemesh.io as its only production API origin.

Requirements

Node.js 20+ and a dedicated, low-balance Base wallet funded with USDC (WALLET_PRIVATE_KEY). The server refuses to sign for any payee other than the Kronos wallet, any network other than Base mainnet, any asset other than USDC, or any amount over the cap ($0.15 per call, $10 per session). The env vars X402_MAX_PRICE_USD and X402_SESSION_BUDGET_USD can only lower those caps. Requests are same-origin, time out after 60 seconds, are capped at 2 MB, and never follow redirects.

Claude Code / Desktop

{
  "mcpServers": {
    "kronos": {
      "command": "npx",
      "args": ["-y", "@forgemeshlabs/kronos-forgemesh-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0x<dedicated-low-balance-wallet-key>"
      }
    }
  }
}

No payment occurs when the server starts or lists its tools. Payment happens only when an agent invokes one of the eleven tools.

Errors are returned as structured KRONOS_TOOL_ERROR payloads so the calling agent can recover without reading server logs.

Market intelligence only. Outputs are not instructions to transact.

Source: https://github.com/forgemeshlabs/kronos-forgemesh-mcp

الأسئلة الشائعة

ما هو io.github.forgemeshlabs/kronos-forgemesh-mcp؟

Kronos market intelligence with calibrated ranges, audits, and x402 payments on Base.

كيف أثبّت io.github.forgemeshlabs/kronos-forgemesh-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add kronos-forgemesh-mcp -e 'WALLET_PRIVATE_KEY=<your wallet_private_key>' -- npx -y @forgemeshlabs/kronos-forgemesh-mcp@0.2.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.forgemeshlabs/kronos-forgemesh-mcp إلى مفتاح API؟

نعم. يتطلب WALLET_PRIVATE_KEY، وتضبطها في إعداداته.

هل io.github.forgemeshlabs/kronos-forgemesh-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.forgemeshlabs/kronos-forgemesh-mcp؟

ينشره forgemeshlabs. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.