# Risk-Aware Trading Agents (pypi · risk-aware-trading-agents)

AI trading agents for US stocks: point-in-time news backtests, a frozen 2026 market, paper trading

- Trust score: 79/100 (medium)
- Change this week: +18
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- mcpb · `risk-aware-trading-agents-0.8.0.mcpb`: 43/100, [markdown](https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents.md), [page](https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents)
- oci · `ghcr.io/jackson-cmd/risk-aware-trading-agents`: 39/100, [markdown](https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/ghcr-io-jackson-cmd-risk-aware-trading-agents.md), [page](https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/ghcr-io-jackson-cmd-risk-aware-trading-agents)
- pypi · `risk-aware-trading-agents`: 79/100 (this document), [markdown](https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents-2.md), [page](https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents-2)

## Channel facts

- Registry: `pypi`
- Package: `risk-aware-trading-agents`
- Version: `0.8.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 5 of 68 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to jackson-cmd/risk-aware-trading-agents).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 6 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 55/100
  - AI-judged instruction clarity (fair).
  - Context-footprint check failed: tool/resource definitions use about 2995 tokens (~136/item across 22 items; 22 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 23 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Risk-Aware Trading Agents MCP server?

Risk-Aware Trading Agents runs locally as a PyPI package, launched with uvx risk-aware-trading-agents mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add jackson-cmd-risk-aware-trading-agents -- uvx risk-aware-trading-agents mcp
```

### Cursor

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

### VS Code

```json
{
  "servers": {
    "jackson-cmd-risk-aware-trading-agents": {
      "command": "uvx",
      "args": [
        "risk-aware-trading-agents",
        "mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add jackson-cmd-risk-aware-trading-agents -- uvx risk-aware-trading-agents mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jackson-cmd-risk-aware-trading-agents": {
      "type": "local",
      "command": [
        "uvx",
        "risk-aware-trading-agents",
        "mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add jackson-cmd-risk-aware-trading-agents --command uvx --arg risk-aware-trading-agents --arg mcp
```

### Hermes

```yaml
mcp_servers:
  jackson-cmd-risk-aware-trading-agents:
    command: "uvx"
    args: ["risk-aware-trading-agents", "mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "jackson-cmd-risk-aware-trading-agents": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "risk-aware-trading-agents",
        "mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add jackson-cmd-risk-aware-trading-agents -t stdio -c uvx -a risk-aware-trading-agents mcp
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 79, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-20 (score 64, −14)

- [security regression] Malware scan: pass → unverified

### 2026-11-19 (score 78, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-18 (score 63, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 62, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-15 (score 77, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-11-14 (score 61, 0)

- [security improvement] Malware scan: unverified → pass
- [functional regression] Schema quality: 111 → 136
- [functional improvement] Stability: unverified → 0.03
- [functional] Package version: 0.7.2 → 0.8.0

### 2026-11-13 (score 61)

First indexed and scored.

## MCP tools (22)

### `market_regime` (~43 tokens)

The market regime the agents see today (risk-on, neutral, uncertain, risk-off), the readings behind it,
and the macro events of the next 30 days.

### `scan` (~46 tokens)

Today's buy and sell signals with their reasons. Scans the configured watchlist unless symbols are given.

Input parameters:

- `profile` (string)
- `strategy` (string)
- `symbols`

### `analyze_stock` (~35 tokens)

What every agent thinks about one stock: technical setups, earnings quality, verified news, the decision.

Input parameters:

- `symbol` (string, required)

### `stock_news` (~82 tokens)

Cross-verified news for one stock: a story counts when two independent outlets, the company's own press
release or its SEC filing carry it. Only a severe flag the company itself backs (its 8-K, or its release
confirming earlier reports) counts as a thesis break; denials clear the stories they refute.

Input parameters:

- `symbol` (string, required)

### `list_strategies` (~39 tokens)

The built-in strategies that backtest and the agents can use, and the strategies saved from backtest_code
(pass their path as the strategy).

### `backtest` (~151 tokens)

Backtest a strategy on daily data (signals at the close, fills the next day) against SPY buy and hold.

news=True replays the news archive: each day the strategy sees only items published before that day's close.
The research headline files (2026 headlines and SEC filings for the built-in watchlists) are licensed and do not
ship with the package; news comes from your local archive and from those files if you have a copy.

Input parameters:

- `cash` (number)
- `end`
- `news` (boolean)
- `profile` (string)
- `start` (string)
- `strategy` (string)
- `symbols`
- `universe` (string)

### `strategy_guide` (~64 tokens)

How to write a strategy for backtest_code: the Strategy class, what ctx holds (indicators, price history,
positions, market regime, point-in-time news), the rules the code must follow, a template and a news
example. Read it before writing code.

### `backtest_code` (~243 tokens)

Backtest a strategy written as Python code (one Strategy subclass; see strategy_guide).

The stocks come from symbols or universe (megacap, tech, defensive, core, etf, sectors), never from the code.
The code is checked first: dates or stock tickers written in the code, files, network and private attributes
are refused, because they let a backtest see the future or touch the machine. It then runs in a separate
process, where each day sees only that day's data and news published before the close. Returns metrics,
SPY and buy-and-hold for comparison, trades and the risk manager's refusals; or the problems to fix, with
line numbers. save_as='name' keeps the code in ~/.riskaware/strategies/ai/ for backtest and agents_create.

Input parameters:

- `cash` (number)
- `code` (string, required)
- `compare`
- `end`
- `news` (boolean)
- `params`
- `profile` (string)
- `save_as`
- `start` (string)
- `symbols`
- `universe`

### `agents_leaderboard` (~31 tokens)

Every paper-trading agent ranked by return since it started, compared with SPY over the same days.

### `agent_detail` (~35 tokens)

One agent: its settings, cash and positions at cost, equity by day and its latest orders.

Input parameters:

- `name` (string, required)

### `agent_decisions` (~97 tokens)

How an agent made its recent decisions: the setups and reasons, whether the risk manager let each one
through, and the LLM's bull case, bear case and verdict when the agent has an LLM. include_prompts adds the
exact prompt sent to the model and its raw reply.

Input parameters:

- `include_prompts` (boolean)
- `limit` (integer)
- `name` (string, required)
- `symbol`

### `agents_create` (~145 tokens)

Create a paper-trading agent: a strategy with its own simulated account that trades every trading day.

strategy is a built-in name or the path of a strategy saved by backtest_code (list_strategies shows both).
llm optionally adds an LLM review board, e.g. "openai:gpt-5.6-luna", "ollama:qwen2.5:3b" or "off".

Input parameters:

- `cash` (number)
- `llm`
- `name` (string, required)
- `note` (string)
- `profile` (string)
- `strategy` (string)
- `symbols`
- `universe`

### `agents_run` (~39 tokens)

Run agents once now on their simulated paper accounts (all active agents when names is empty).

Input parameters:

- `dry_run` (boolean)
- `names`

### `research_guide` (~131 tokens)

Read this first for experiments on the frozen markets: what data ships with the package (three periods:
2026 to date, the 2022 bear market and the 2020 crash, each with daily bars and the VIX term structure; each
year's headline file is licensed and not distributed, so news needs your own copy), how a backtest decides and
fills (after the close,
at the next open: swing trading), the look-ahead rules and check, how to write a strategy, the five baseline
swing strategies, what a saved record holds, and advice for papers.

### `market_day` (~245 tokens)

Everything known at the close of one day of the bundled periods (2018 to 2020, 2020 to 2022, 2024 to
2026-11-11; news in 2020, 2022 and 2026 when you have a copy of the headline files, which are not distributed):
the market regime, VIX, VIX9D, VIX3M, VVIX and the term structure, fear & greed, breadth, credit stress, the
macro events of the next two weeks; and per stock its prices and returns, indicators (EMAs, RSI, MACD, ATR, ADX,
Bollinger, 52-week high), technical setups and the news published before the close (score, verified status,
red flags, headlines, last earnings release). Nothing after that close is visible. Without symbols it lists all
64 stocks in a compact table; name up to 10 symbols for the full detail with headlines. A weekend or holiday
shows the close before it.

Input parameters:

- `day` (string, required)
- `headlines` (integer)
- `news` (boolean)
- `symbols`

### `run_experiment` (~605 tokens)

Run an experiment on a frozen period and save a record (see research_guide). period is 2026 (default, a
rising year), 2022 (the rate-hike bear market) or 2020 (the COVID crash and rebound); start and end default to
the period's test window. costs='fixed' (default) pays 5 bps on every fill at the open; costs='realistic' adds
10% of the overnight gap and square-root market impact and fills each order for at most 1% of its 20-day
average volume. mode (plain execution) is long_only (default), long_short (short positions with a signed
target_weight, e.g. Signal(sym, Action.SELL, target_weight=-0.1), long plus short at most 100% of equity, each
short at most 20%, 0.5% a year borrow fee) or margin (Reg T: up to 200% gross, maintenance margin calls, borrowed
cash pays BIL + 1.5%); mode_params overrides those rules. The rule-based long-short anchors are momentum_ls and
trend_ls.

Give either strategy (a built-in name such as swing_rsi2, swing_trend, swing_breakout, swing_pullback,
swing_news, risk_aware, rsi2, momentum_rotation; or the path of a saved strategy) or code (one Strategy class,
as in strategy_guide; it is checked and runs in a separate process). Signals at each close, market orders at the
next open. execution='plain' trades exactly what the strategy says (equal-size positions, at most max_positions);
'risk_aware' adds the package's risk manager. split='2026-07-01' also reports the parts before and after. The
leak check re-runs it with a random future after three cut days and compares the decisions. extra_news adds
headlines ({ts, symbol, headline, source}) for counterfactual or robustness tests. Returns the metrics, SPY and
the equal-weight universe, beta, alpha, t-statistic and bootstrap intervals, the leak-check verdict, the best and
worst trades, and the folder of the record (manifest with data hashes, metrics, equity, trades, decisions,
report.md, chart).

Input parameters:

- `code`
- `costs` (string)
- `end`
- `execution` (string)
- `extra_news`
- `label`
- `leak_check` (boolean)
- `max_positions` (integer)
- `mode` (string)
- `mode_params`
- `news` (boolean)
- `params`
- `period` (string)
- `position_size`
- `split`
- `start`
- `strategy`
- `symbols`
- `universe`

### `list_experiments` (~53 tokens)

Saved research experiments and trading sessions, newest first: strategy, period, return, Sharpe, SPY and the
look-ahead verdict, with the folder of each record.

Input parameters:

- `limit` (integer)

### `experiment_report` (~34 tokens)

The report (markdown, ready to paste), manifest and file list of one saved experiment.

Input parameters:

- `run_id` (string, required)

### `trading_session_start` (~264 tokens)

Trade the frozen market yourself, one decision at a time (an LLM-agent experiment). Returns the rules and
the first observation: the market, your portfolio, and per stock the main indicators and the news published
before that close. Answer with trading_session_step. decide_every=5 decides once a week (about 44 steps for
2026); 1 decides every day. blind=True hides tickers, company names and dates so that you cannot recall what
happened. Orders fill at the next open; long only; at most max_positions stocks. period is 2026 (default), 2022
or 2020. mode='long_short' also allows short positions (no leverage) and mode='margin' a Reg T margin account
(up to 2x gross, margin calls); the returned rules say what each allows and costs.

Input parameters:

- `blind` (boolean)
- `cash` (number)
- `decide_every` (integer)
- `end`
- `max_news` (integer)
- `max_positions` (integer)
- `mode` (string)
- `news` (boolean)
- `period` (string)
- `start`
- `symbols`
- `universe`

### `trading_session_step` (~151 tokens)

Send the orders for the current step and get the next observation (or, after the last step, the result
with its saved record). Each order: {"symbol", "action": "buy" | "sell" | "target", "weight" (share of equity
for buy and target), "fraction" (share of the position for sell, 1 = all), "reason"}. An empty list holds. In a
long_short or margin session also "short" (weight = size of the short) and "cover" (fraction of a short), and
target takes a negative weight.

Input parameters:

- `note`
- `orders`
- `session_id` (string, required)

### `trading_session_status` (~36 tokens)

Settings, steps sent so far and the record folder (when finished) of a trading session.

Input parameters:

- `session_id` (string, required)

### `experiment_analysis` (~206 tokens)

What a saved experiment or a finished trading session made its money on. Decisions: the excess return over
SPY 1, 5 and 20 trading days after every buy and sell (a sell counts the excess it avoided), with hit rates and
t-statistics that allow for same-day decisions and overlapping windows, and the rank IC of each decision day
against the next five days. Factors: daily returns regressed on the market, size, growth and momentum with
Newey-West t-statistics, the alpha left after them and what each exposure contributed. P&L: by holding period,
sector, market regime, news-triggered or not, and stock; the best and worst positions; how much of the profit
rests on one or two trades. Writes analysis.json, analysis.md and analysis.png into the record. run_id is a run
id or folder from list_experiments, or a trading session id.

Input parameters:

- `run_id` (string, required)

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents-2#diagnostics

## Score history

- 2026-11-21: 79
- 2026-11-20: 64
- 2026-11-19: 78
- 2026-11-18: 63
- 2026-11-17: 62
- 2026-11-16: 77
- 2026-11-15: 77
- 2026-11-14: 61
- 2026-11-13: 61

## Common questions

### What is the Risk-Aware Trading Agents MCP server?

Risk-Aware Trading Agents is an MCP server listed in the public MCP registry as io.github.jackson-cmd/risk-aware-trading-agents. AI trading agents for US stocks: point-in-time news backtests, a frozen 2026 market, paper trading. This page covers its PyPI package (risk-aware-trading-agents).

### Is the Risk-Aware Trading Agents MCP server safe to use?

Risk-Aware Trading Agents scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Risk-Aware Trading Agents MCP server expose?

Risk-Aware Trading Agents exposes 22 tools: market_regime, scan, analyze_stock, stock_news, list_strategies, and 17 more. Their descriptions and schemas cost roughly 2,775 tokens of context every time the server is loaded.

### Is the Risk-Aware Trading Agents MCP server still maintained?

Risk-Aware Trading Agents is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Risk-Aware Trading Agents MCP server under?

Risk-Aware Trading Agents declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Risk-Aware Trading Agents MCP server?

VerifyMCP ran 16 checks on Risk-Aware Trading Agents, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- PyPI project: https://pypi.org/project/risk-aware-trading-agents/
- Socket report: https://socket.dev/pypi/package/risk-aware-trading-agents
- Repository: https://github.com/jackson-cmd/risk-aware-trading-agents
- Website: https://jackson-cmd.github.io/risk-aware-trading-agents/
- Changelog RSS feed: https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents-2.xml
- Changelog JSON feed: https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents-2/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents-2.json
- HTML version of this page: https://verifymcp.io/servers/jackson-cmd-risk-aware-trading-agents/risk-aware-trading-agents-2
