Skip to content
MCP server

Risk-Aware Trading Agents

Benchmarks LLM trading agents on news replayed by publication time, plus paper trading

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, Web, self-hosted
Runs
Locally
Version
0.8.0
Listing updated
3 days ago

About Risk-Aware Trading Agents

Risk-Aware Trading Agents is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

The benchmark's argument is that most news backtests join headlines to prices by calendar date, so a post-close headline gets traded at that close. Here each headline arrives at its publication minute and orders fill at the next open, across three frozen markets: the 2020 crash, the 2022 bear market and 2026. On its example signal, date joining shows +32 bp a trade while publication-time joining shows -6.7 bp.

Models from Llama, GPT, Claude and Gemini trade 56 stocks blind and named, three seeds each, scored separately before and after each model's training cutoff. The 65,863 headlines and filings are licensed and not distributed, so replay uses news you bring, such as free SEC 8-K filings.

The same package is a long-only strategy for US stocks that keeps 30% in cash or T-bills, with paper and live trading on 10 brokers. The README notes a backtest shows what would have happened, not what will. MIT, installed via pip, Docker or MCPB.

Install

Run in a terminal

claude mcp add risk-aware-trading-agents -- uvx risk-aware-trading-agents

Add to claude_desktop_config.json

{
  "mcpServers": {
    "risk-aware-trading-agents": {
      "command": "uvx",
      "args": [
        "risk-aware-trading-agents"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "risk-aware-trading-agents": {
      "command": "uvx",
      "args": [
        "risk-aware-trading-agents"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "risk-aware-trading-agents": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "risk-aware-trading-agents"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "risk-aware-trading-agents": {
      "command": "uvx",
      "args": [
        "risk-aware-trading-agents"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "risk-aware-trading-agents": {
      "command": "uvx",
      "args": [
        "risk-aware-trading-agents"
      ]
    }
  }
}

What it does

Publication-time replay
Headlines arrive at publication minute.
Frozen markets
2020, 2022 and 2026.
LLM leaderboard
Models scored around training cutoff.
Prompt leaderboard
Prompt changes tested on same seeds.
Paper trading
Agents ranked against SPY.

Good for

  • Test an LLM's trading judgement
  • Backtest without look-ahead
  • Compare system prompts
  • Paper trade US stocks

Pricing

Open source

Prices change. Check jackson-cmd.github.io before you buy.

Risk-Aware Trading Agents FAQ

Is the news included?

No, licensed headlines are not distributed.

Does it hold cash?

Yes, 30% in cash or T-bills.

Licence?

MIT.

Needs a key?

Not for the listed commands.

Is Risk-Aware Trading Agents free?

Yes. Risk-Aware Trading Agents is open source, so you can use and self-host it for free.

How do I add Risk-Aware Trading Agents to Claude Code?

Run this command in your terminal: claude mcp add risk-aware-trading-agents -- uvx risk-aware-trading-agents

What are the best alternatives to Risk-Aware Trading Agents?

The closest alternatives to Risk-Aware Trading Agents are Claude Code Ultimate Guide, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker and Quantivex Research.

Alternatives to Risk-Aware Trading Agents

  1. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  5. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  6. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments