# Papertrade AI (npm · papertrade-ai)

Trade Papertrade BTC and ETH perps from Claude, ChatGPT, Codex, Cursor and any MCP client.

- Trust score: 76/100 (medium)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-25

## Components

- remote · `papertrade-ai.ninabrekkerese.workers.dev`: 32/100, [markdown](https://verifymcp.io/servers/nirholas-papertrade-ai/papertrade-ai.md), [page](https://verifymcp.io/servers/nirholas-papertrade-ai/papertrade-ai)
- npm · `papertrade-ai`: 76/100 (this document), [markdown](https://verifymcp.io/servers/nirholas-papertrade-ai/papertrade-ai-2.md), [page](https://verifymcp.io/servers/nirholas-papertrade-ai/papertrade-ai-2)

## Channel facts

- Registry: `npm`
- Package: `papertrade-ai`
- Version: `0.1.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-10-25.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 3 of 32 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 14 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 80/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1166 tokens (~77/item across 15 items; 14 tools + 1 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 37/100
  - Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 89/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 67% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 14 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 16 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).
  - Supports UI / widget rendering.

## Install

### How do I install the Papertrade AI MCP server?

Papertrade AI runs locally as an npm package, launched with npx -y papertrade-ai. 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 nirholas-papertrade-ai -- npx -y papertrade-ai
```

### Cursor

```json
{
  "mcpServers": {
    "nirholas-papertrade-ai": {
      "command": "npx",
      "args": [
        "-y",
        "papertrade-ai"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "nirholas-papertrade-ai": {
      "command": "npx",
      "args": [
        "-y",
        "papertrade-ai"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add nirholas-papertrade-ai -- npx -y papertrade-ai
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "nirholas-papertrade-ai": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "papertrade-ai"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add nirholas-papertrade-ai --command npx --arg -y --arg papertrade-ai
```

### Hermes

```yaml
mcp_servers:
  nirholas-papertrade-ai:
    command: "npx"
    args: ["-y", "papertrade-ai"]
```

### Netclaw

```json
{
  "McpServers": {
    "nirholas-papertrade-ai": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "papertrade-ai"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add nirholas-papertrade-ai -t stdio -c npx -a -y papertrade-ai
```

### Other

```json
{
  "mcpServers": {
    "nirholas-papertrade-ai": {
      "command": "npx",
      "args": [
        "-y",
        "papertrade-ai"
      ]
    }
  }
}
```

## 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-10-24 (score 76, +1)

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

### 2026-10-22 (score 75, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-10-14 (score 71, +31)

- [security improvement] Injection markers: unverified → pass
- [security] First check of Judged manipulation: pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 100
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Tool coverage: 67
- [functional] First check of Schema quality: fail
- [functional] First check of Destructive annotations: pass
- [functional] First check of Capabilities: pass
- [functional] First check of Schema quality: pass
- [functional] First check of Schema quality: good

### 2026-10-12 (score 40)

First indexed and scored.

## MCP tools (14)

### `get_markets` (~63 tokens)

Markets

Live Papertrade perp markets (BTC, ETH): Hyperliquid mark/bid/ask, 24h change, Papertrade 24h volume, open interest vs caps, max leverage, minimum trade size and whether each market is open. Call this before trading.

### `get_price_chart` (~71 tokens)

Price chart

OHLCV candles for BTC or ETH from Hyperliquid (the price source Papertrade settles against), with range stats and a TradingView link.

Input parameters:

- `count` (integer): Number of candles.
- `interval` (string): Candle interval.
- `market` (string, required): Market symbol: BTC or ETH.

### `get_protocol_stats` (~63 tokens)

Protocol stats

Papertrade protocol analytics: TVL, margin, LP, lifetime volume, open positions, fees, PAPER supply and staking, plus daily history (volume, trader PnL, liquidations, users).

Input parameters:

- `days` (integer): Days of daily history to include.

### `get_liquidation_map` (~55 tokens)

Liquidation map

Where open Papertrade positions get liquidated: notional and position count of longs and shorts by price bucket around the current price, with the largest clusters.

Input parameters:

- `market` (string, required): Market symbol: BTC or ETH.

### `get_leaderboard` (~92 tokens)

Leaderboard

Papertrade trader leaderboard for a time window, sortable by PnL, volume, balance and more. Search by name or address with q.

Input parameters:

- `page` (integer): 0-based page; 25 rows per page.
- `q` (string): Filter by leaderboard name or address.
- `sortDir` (string)
- `sortKey` (string)
- `window` (string)

### `get_top_trades` (~44 tokens)

Top trades

The most profitable individual Papertrade positions in a window: who, market, side, leverage, entry, exit and PnL.

Input parameters:

- `window` (string)

### `get_recent_trades` (~51 tokens)

Recent trades

The latest opens, closes and liquidations across all of Papertrade, optionally filtered by market or wallet.

Input parameters:

- `market` (string): Market symbol: BTC or ETH.
- `wallet` (string)

### `get_account` (~71 tokens)

Account

A Papertrade account: free balance, locked margin, equity, every open position with live estimated PnL, bust price and distance to liquidation, pending intents, session keys and lifetime stats. Any wallet can be inspected.

Input parameters:

- `wallet` (string): Wallet address (0x...). Defaults to the connected wallet.

### `get_trade_history` (~66 tokens)

Trade history

Closed and liquidated positions for a wallet, newest first, with entry, exit, settled PnL, fees and PAPER minted.

Input parameters:

- `pages` (integer): Pages of 75 trades.
- `wallet` (string): Wallet address (0x...). Defaults to the connected wallet.

### `get_portfolio_history` (~56 tokens)

Portfolio history

Equity curve for a wallet over 1h, 1d, 1w or all time.

Input parameters:

- `range` (string)
- `wallet` (string): Wallet address (0x...). Defaults to the connected wallet.

### `calculate_position` (~130 tokens)

Position calculator

Pure math for a hypothetical position: bust price, liquidation distance and settled PnL at a target exit, using the exchange formula (win curve, deadband, 2% win fee). Does not need a wallet.

Input parameters:

- `entryPrice` (number): Defaults to the live ask (long) or bid (short).
- `exitPrice` (number): Target exit to evaluate.
- `leverage` (integer, required)
- `marginUsd` (number, required)
- `market` (string, required): Market symbol: BTC or ETH.
- `side` (string, required): long profits if price rises, short if it falls.

### `get_deposit_info` (~80 tokens)

Deposit instructions

How to fund a Papertrade account: the wallet's personal deposit proxy address (USDC on HyperCore spot), minimums, the activation fee, and the wallet's current HyperEVM USDC/HYPE balances. Read-only; it never moves funds.

Input parameters:

- `wallet` (string): Wallet address (0x...). Defaults to the connected wallet.

### `get_trading_permissions` (~47 tokens)

Trading permissions

What this connection may do: connected wallet, whether a trading session is active and when it expires, the guardrails the owner set, and how much of the daily limit is used.

### `get_intent_status` (~56 tokens)

Intent status

Whether a submitted intent is still queued, has produced an open position, or is no longer pending.

Input parameters:

- `intentId` (string, required)
- `wallet` (string): Wallet address (0x...). Defaults to the connected wallet.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/nirholas-papertrade-ai/papertrade-ai-2#diagnostics

## Score history

- 2026-10-25: 76
- 2026-10-24: 76
- 2026-10-23: 75
- 2026-10-22: 75
- 2026-10-21: 71
- 2026-10-20: 71
- 2026-10-19: 71
- 2026-10-18: 71
- 2026-10-17: 71
- 2026-10-16: 71
- 2026-10-15: 71
- 2026-10-14: 71
- 2026-10-13: 40
- 2026-10-12: 40

## Common questions

### What is the Papertrade AI MCP server?

Papertrade AI is an MCP server listed in the public MCP registry as io.github.nirholas/papertrade-ai. Trade Papertrade BTC and ETH perps from Claude, ChatGPT, Codex, Cursor and any MCP client. This page covers its npm package (papertrade-ai).

### Is the Papertrade AI MCP server safe to use?

Papertrade AI scores 76 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 25 October 2026. It declares no install or post-install scripts. 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 Papertrade AI MCP server expose?

Papertrade AI exposes 14 tools: get_markets, get_price_chart, get_protocol_stats, get_liquidation_map, get_leaderboard, and 9 more. Their descriptions and schemas cost roughly 945 tokens of context every time the server is loaded.

### Is the Papertrade AI MCP server still maintained?

Papertrade AI is still listed as active in the MCP registry. We last reached this channel on 25 October 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 Papertrade AI MCP server under?

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

## Links

- npm package: https://www.npmjs.com/package/papertrade-ai
- Socket report: https://socket.dev/npm/package/papertrade-ai
- Repository: https://github.com/nirholas/papertrade-ai
- Website: https://papertrade-ai.ninabrekkerese.workers.dev/
- Changelog RSS feed: https://verifymcp.io/servers/nirholas-papertrade-ai/papertrade-ai-2.xml
- Changelog JSON feed: https://verifymcp.io/servers/nirholas-papertrade-ai/papertrade-ai-2.json
- HTML version of this page: https://verifymcp.io/servers/nirholas-papertrade-ai/papertrade-ai-2