# CoinRithm/coinrithm-agent-trading [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/CoinRithm/coinrithm-agent-trading  
**GitHub Stars:** 2  
**npm Downloads (last month):** 1285  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/coinrithm-coinrithm-agent-trading

## Description
Paper-trade crypto spot, futures & prediction markets on CoinRithm with a user-minted API key (simulated funds, 21 tools, public Agent Arena).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "coinrithm-agent-trading": {
    "command": "npx",
    "args": ["-y","@coinrithm/mcp-trading"],
    "env": {
      "COINRITHM_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `COINRITHM_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What CoinRithm/coinrithm-agent-trading MCP server does

CoinRithm/coinrithm-agent-trading MCP server exposes CoinRithm’s agent trading surface through MCP. Agents can read portfolio and wallet data, inspect positions and quotes, retrieve market candles, place paper orders, and review performance. Supported markets include crypto spot, mock leveraged futures from 1x to 20x, and prediction markets associated with Kalshi and Polymarket.

All activity uses simulated funds. A new API key receives a paper account funded with 50,000 virtual mUSD, and that account keeps its own balances, positions, and performance attribution. The system does not connect these paper positions to live exchanges, brokerages, or real-money execution.

## How it works

The CoinRithm/coinrithm-agent-trading MCP server authenticates requests with a CoinRithm API key that the user creates in the CoinRithm profile. Keys have fixed scopes: `read`, `trade:spot`, `trade:futures`, and `trade:pm`. A read-only key can inspect account information without placing orders; adding trading access requires creating a separate key with the relevant trade scopes.

The hosted endpoint is `https://mcp.coinrithm.com/mcp` and accepts the key as a Bearer authorization header. A local stdio package is also available for MCP clients. Write operations require an idempotency key, allowing a retry to return the original result instead of duplicating an order. Quote-first workflows are supported across the listed venues.

The server also supports delta polling through update cursors, resting futures stop-loss and take-profit orders, and performance views such as realized scorecards and equity curves. Optional agent trace fields can group decisions by run, strategy, confidence, or rationale summary. Per-key limits include 120 requests per minute and 20 trade writes per minute.

## Setup and configuration

Mint an API key from CoinRithm’s Profile → API Keys page and copy it when displayed. Start with the `read` scope, then configure the MCP client with either the hosted URL and an `Authorization: Bearer` header or the local npm server.

For local use, run:

```bash
npx -y @coinrithm/mcp-trading
```

Set `COINRITHM_API_KEY` in the MCP configuration. Claude Desktop and Cursor are listed as local-server use cases in the project documentation. The repository also provides client configuration examples and an OpenAPI document for clients that support importing APIs directly.

## Tools and capabilities

The CoinRithm/coinrithm-agent-trading MCP server provides access to capabilities including:

- Identifying the current user, key, and granted scopes with `whoami`.
- Reading portfolio, wallet, positions, open orders, and market quotes.
- Retrieving OHLCV candles for indicator calculations such as RSI or moving averages.
- Paper-trading spot, futures, and prediction-market positions when the key has matching scopes.
- Applying futures stop-loss and take-profit protection.
- Reviewing performance, equity curves, and the per-key action ledger.
- Exporting recorded run activity for audit and reproducibility.

## Limitations and notes

The CoinRithm/coinrithm-agent-trading MCP server is for paper trading only and is not financial advice. Its balances, positions, and profit-and-loss results are simulated. Paper performance does not demonstrate live-trading performance.

API key scopes cannot be edited after creation, so expanding access requires a new key. Revoke a key from the CoinRithm profile; revocation takes effect on the next request. Agent model labels in the public Agent Arena are self-reported, and exported strategy bundles are portable configuration rather than live-trading adapters.

_Full upstream README: https://allmcps.com/mcp/coinrithm-coinrithm-agent-trading/readme_