Kronos Forgemesh Mcp

io.github.forgemeshlabsPublished by GitHub account forgemeshlabsv0.2.3Updated Nov 3, 2026

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

VerifiedSTDIODesktop onlyFinanceData & Analytics

Overview

Kronos Forgemesh's local MCP server; no sign-in required; STDIO; 11 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Installation

In SourceWeft

  1. Open Kronos Forgemesh 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

Kronos by ForgeMesh MCP

[M8ven Verified] [mcpservers.org]

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

bash
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

json
{  "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

Source: README.md at commit 37aad58

Tools

11

get_kronos_signals

Get current Kronos signal context and ranked symbols for BTC, ETH, SOL, XRP, and ADA. Costs $0.05 USDC.

Takes no parameters.

get_kronos_risk

Get current Kronos market-risk state, signal streaks, and cooldown context. Costs $0.02 USDC.

Takes no parameters.

get_kronos_history

Get up to 168 hours of timestamped Kronos signal history for analysis and audit support. Costs $0.05 USDC.

Parametershours

get_kronos_forecast

Get a conformally calibrated 80% price range, current price, and upside probability for a supported symbol. Costs $0.05 USDC.

Parameterssymbol

check_kronos_preflight

Check market state, cooldowns, freshness, and warnings before creating a Kronos decision journal. Costs $0.05 USDC.

Parameterssymbolrequired

create_kronos_decision

Create an auditable Kronos market-intelligence journal entry with directional bias, calibrated confidence, and decision_id. Costs $0.15 USDC.

Parameterssymbolrequired

audit_kronos_decision

Audit a prior Kronos decision_id against later prices and return its outcome verdict. Costs $0.07 USDC.

Parameterswindowdecision_idrequired

get_kronos_whale_flows

Get whale, exchange, bridge, and stablecoin-flow context for Ethereum, Base, or Arbitrum. Costs $0.02 USDC.

Parameterschainhours

get_kronos_futures_decision

Kronos Futures: perpetual-futures decision package for a symbol. Direction LONG / SHORT / FLAT from the Kronos signal, stop-loss and take-profit on the calibrated 80% range, leverage cap keeping liquidation outside 2x the stop, liquidation price, risk-based position size for your equity, and live perp funding cost. Market intelligence only; no exchange execution. Costs $0.15 USDC.

Parametersequitysymbolrequiredmax_leveragemax_loss_pct

get_kronos_perp_funding

Kronos Futures: live perpetual funding rates (1h, 8h, annualized), mark and index price, open interest, and a LONG_CROWDED / SHORT_CROWDED / BALANCED crowding label for BTC, ETH, SOL, XRP, and ADA from Kraken Futures and Hyperliquid. Costs $0.02 USDC.

Parameterssymbol

check_kronos_futures_risk

Kronos Futures: will a leveraged perp position survive the calibrated range? Returns liquidation price and distance, the adverse range bound, a SURVIVES_RANGE / THIN_BUFFER / LIQUIDATION_INSIDE_RANGE verdict, the max leverage that still survives, P&L at both range bounds, and funding cost. Costs $0.05 USDC.

Parameterssiderequiredentrysymbolleveragerequirednotionalhorizon_hours

Version history

4
  1. v0.2.3LatestNov 3, 2026
  2. v0.2.2Oct 8, 2026
  3. v0.2.0Oct 5, 2026
  4. v0.1.2Sep 16, 2026

Score

90% 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
  • 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 listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts