# Kronos Forgemesh MCP

> Kronos Forgemesh MCP is a paid MCP server for finance and payments. Pay-per-call MCP server for Kronos crypto market ranges, audits and futures risk checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI
- **Repository:** https://github.com/forgemeshlabs/kronos-forgemesh-mcp
- **MCP Registry name:** io.github.forgemeshlabs/kronos-forgemesh-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

Agents using this server buy structured Kronos market intelligence from kronos.forgemesh.io, paying in USDC on Base through x402. Nothing is charged when the server starts or lists tools; payment happens only when one of the eleven tools is called, at prices from $0.02 to $0.15.

The core products are a calibrated 80% price range with upside probability, signal history up to 168 hours, risk state and whale flows, plus a decision journal and an audit of a prior decision_id. Three futures tools read live perp funding from Kraken Futures and Hyperliquid and check whether a side, leverage and entry would survive the calibrated range. The README says no exchange execution ever happens and outputs are not trade instructions.

Spending is capped in code: $0.15 per call and $10 per session by default, with environment variables that can only lower those caps. The wallet key stays local, and the README advises a dedicated low-balance wallet.

## Features

- **Calibrated forecast:** An 80% range and upside probability.
- **Decision journal:** Creates an auditable record and audits it later by decision_id.
- **Futures risk checks:** Liquidation distance and verdict for a side, leverage and entry.
- **Perp funding data:** Funding, mark and index prices and open interest from two venues.
- **Spending caps:** $0.15 per call and $10 per session maximums.
- **Origin allowlist:** Only the Kronos production origin is called.

## Good for

- Get a calibrated price range before an agent acts
- Journal a decision and audit its outcome later
- Check whether a leveraged position survives the range
- Monitor perp funding and crowding

## Install

### Claude Code (Terminal)

```sh
claude mcp add kronos-forgemesh-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/kronos-forgemesh-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kronos-forgemesh-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/kronos-forgemesh-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kronos-forgemesh-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/kronos-forgemesh-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kronos-forgemesh-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/kronos-forgemesh-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kronos-forgemesh-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/kronos-forgemesh-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kronos-forgemesh-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/kronos-forgemesh-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `get_kronos_risk`: Risk state, streaks and cooldown context.
- `get_kronos_whale_flows`: Whale, exchange, bridge and stablecoin flows.
- `get_kronos_signals`: Current multi-symbol signal context.
- `get_kronos_history`: Up to 168 hours of signal history.
- `get_kronos_forecast`: Calibrated 80% range and upside probability.
- `check_kronos_preflight`: Conditions check before journaling.
- `audit_kronos_decision`: Outcome audit for a prior decision_id.
- `create_kronos_decision`: Auditable market-intelligence journal entry.
- `get_kronos_perp_funding`: Live perp funding, mark and index, open interest, crowding.
- `check_kronos_futures_risk`: Liquidation distance and verdict for a futures setup.
- `get_kronos_futures_decision`: LONG, SHORT or FLAT with stop, target, leverage cap and sizing.

## FAQ

### How is it paid for?

Each tool call is paid in USDC on Base via x402 from a wallet you configure with WALLET_PRIVATE_KEY.

### What does a call cost?

Between $0.02 and $0.15 depending on the tool, per the README.

### Can it place trades?

No. The README states no exchange execution happens and outputs are market intelligence only.

### What are the safety limits?

A $0.15 per-call cap and $10 session cap, USDC on Base only, one fixed payee, no redirects.

### Is Kronos Forgemesh MCP free?

No. Kronos Forgemesh MCP is a paid product.

### How do I add Kronos Forgemesh MCP to Claude Code?

Run this command in your terminal: claude mcp add kronos-forgemesh-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/kronos-forgemesh-mcp

### What are the best alternatives to Kronos Forgemesh MCP?

The closest alternatives to Kronos Forgemesh MCP are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/kronos-forgemesh-mcp
