# Risk-Aware Trading Agents

> Risk-Aware Trading Agents is an open-source MCP server for finance and payments. Benchmarks LLM trading agents on news replayed by publication time, plus paper trading. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Web, self-hosted
- **Website:** https://jackson-cmd.github.io/risk-aware-trading-agents/
- **Repository:** https://github.com/jackson-cmd/risk-aware-trading-agents
- **MCP Registry name:** io.github.jackson-cmd/risk-aware-trading-agents
- **Categories:** finance and payments, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

```json
{
  "mcpServers": {
    "risk-aware-trading-agents": {
      "command": "uvx",
      "args": [
        "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

- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [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.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/risk-aware-trading-agents
