# Coinopai MCP

> Coinopai MCP is a paid MCP server for finance and payments. Pay-per-call MCP server for crypto forecast ranges, decision audits and automation prompts. It runs locally on your machine and is started by your AI client.

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

## About

Built around a three-step loop of preflight, decision and audit, this server lets agents buy Kronos market context from x402.coinopai.com with USDC micropayments on Base. A full loop costs $0.27: a $0.05 preflight, a $0.15 decision with a decision_id, and a $0.07 audit an hour later that fetches real prices and returns a verdict and pnl_pct.

It is candid about limits. The README says Kronos is not a buy/sell oracle, that no directional edge was demonstrated in backtest (about 51% accurate), and that the validated product is the conformally calibrated 80% range, with roughly 0.80 empirical coverage across BTC, ETH, SOL, XRP and ADA.

Other tools cover futures funding and risk, anomaly review of signal features, and a small library of agent automation prompts (819 prompts in 35 categories). The handshake is free; only tool calls are charged.

## Features

- **Auditable loop:** Preflight, decision and audit tied together by a decision_id.
- **Calibrated forecast:** 80% price range for five major coins.
- **Futures tools:** Funding, risk check and a sized futures decision.
- **Anomaly review:** Scores signal features and explains drivers.
- **Automation prompt library:** Search 819 prompts across 35 categories.
- **Automatic x402 payment:** Signs USDC micropayments from a configured wallet.

## Good for

- Run a preflight check before an agent acts
- Journal a decision and audit it an hour later
- Get a calibrated BTC or ETH range
- Review whether signals look unusual
- Find a ready-made agent workflow prompt

## Install

### Claude Code (Terminal)

```sh
claude mcp add coinopai-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y coinopai-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "coinopai-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "coinopai-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "coinopai-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "coinopai-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "coinopai-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "coinopai-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "coinopai-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "coinopai-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "coinopai-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "coinopai-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `check_trade_preflight`: Gate check on market state, cooldown and regime.
- `get_crypto_decision`: Decision journal entry with a decision_id.
- `audit_trade_decision`: Verifies a decision against real prices.
- `get_crypto_signals`: Model context for BTC, ETH, SOL, XRP and ADA.
- `get_crypto_signal_history`: Up to 168 hours of context history.
- `get_crypto_forecast`: Calibrated 80% price range.
- `get_perp_funding`: Live perp funding and open interest.
- `check_futures_risk`: Liquidation distance and verdict.
- `get_futures_decision`: LONG, SHORT or FLAT with sizing.
- `review_signal_anomaly`: Scores signal features for unusual conditions.
- `get_crypto_risk`: Market risk state and cooldown.
- `search_agent_automations`: Searches agent automation prompts.
- `get_agent_automation`: Full prompt and workflow by slug.
- `list_automation_categories`: Lists automation categories with counts.

## FAQ

### What does a full loop cost?

$0.27: preflight $0.05, decision $0.15 and audit $0.07.

### Does it predict direction well?

The README reports no demonstrated directional edge in backtest, about 51% accurate, and positions the calibrated range as the validated output.

### Do I need an API key?

No; you pay per call in USDC from a wallet set in WALLET_PRIVATE_KEY.

### Is there a hosted MCP endpoint?

Yes, https://x402.coinopai.com/mcp; initialize, ping and tools/list are free.

### Is Coinopai MCP free?

No. Coinopai MCP is a paid product.

### How do I add Coinopai MCP to Claude Code?

Run this command in your terminal: claude mcp add coinopai-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y coinopai-mcp

### What are the best alternatives to Coinopai MCP?

The closest alternatives to Coinopai 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/coinopai-mcp-2
