English Français العربية

io.github.forgemeshlabs/kronos-forgemesh-mcp

Official registry Finance and payments

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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 configuration (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>"
            }
        }
    }
}

Environment variables

  • WALLET_PRIVATE_KEY required secret Dedicated low-balance Base wallet private key for x402 USDC payments.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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

Frequently asked questions

What is io.github.forgemeshlabs/kronos-forgemesh-mcp?

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

How do I install io.github.forgemeshlabs/kronos-forgemesh-mcp?

It runs on your machine. In 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. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.forgemeshlabs/kronos-forgemesh-mcp need an API key?

Yes. It expects WALLET_PRIVATE_KEY, which you set in its configuration.

Is io.github.forgemeshlabs/kronos-forgemesh-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.forgemeshlabs/kronos-forgemesh-mcp?

It is published by forgemeshlabs. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.