mcpField
K
kronos-forgemesh-mcp

kronos-forgemesh-mcp

Local
github.com/forgemeshlabsFinance1Updated 3w ago
Repository

About kronos-forgemesh-mcp

kronos-forgemesh-mcp is an MCP server for agents to access Kronos market intelligence, paid per call in USDC on Base via x402. It covers spot and futures signals, calibrated ranges, and decision audits; it does not execute trades.

Key features

  1. 01Check risk state and whale flows
  2. 02View signals and up to 168 hours of history
  3. 03Get calibrated ranges and upside probability
  4. 04Create decision journals and audit outcomes
  5. 05Analyze futures funding and risk
  6. 06Get futures direction, stops, and sizing

Use cases

  1. 01Review market risk and flow changes
  2. 02Inspect historical signals and forecast ranges
  3. 03Record decisions and audit outcomes later
  4. 04Assess futures leverage, liquidation distance, and costs

MCP support

Exposes 11 Kronos market-intelligence tools to agents as a stdio MCP server. Tool calls use x402 payments in USDC on Base; the server does not execute trades.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "forgemeshlabs-kronos-forgemesh": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/kronos-forgemesh-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
Run commandnpx -y @forgemeshlabs/kronos-forgemesh-mcp
Environment variables to set
WALLET_PRIVATE_KEYSecretDedicated low-balance Base wallet private key for x402 USDC payments.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@forgemeshlabs/kronos-forgemesh-mcp0.2.2

Tools

11

Saved tool list · updated 2w ago

This tool takes no parameters.

Details

From the project 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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.