Papertrade AI
NPM · PAPERTRADE-AI · 2 COMPONENTS
Trade Papertrade BTC and ETH perps from Claude, ChatGPT, Codex, Cursor and any MCP client.
Available components
Last scanned (4 hours ago)
Scores higher than 57% of npm servers
Category Finance and Payments
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. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 3 of 32 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 14 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability80
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 1166 tokens (~77/item across 15 items; 14 tools + 1 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management37
- Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage89
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 67% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 14 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 16 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
- Supports UI / widget rendering.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 24 Oct 26 +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.
- 22 Oct 26 +4
- Stability: unverified → 0.27 ▲ functional
- 14 Oct 26 +31
- 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). security
- Tool coverage: unverified → 100 ▲ functional
- Schema quality: unverified → 100 ▲ functional
- 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 functional
- 12 Oct 26 40
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 25 Oct 2026 · Analysed npm/papertrade-ai@0.1.0
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 32 packages
| Packages resolved | 32 |
|---|---|
| Stale | 3 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
calculate_position Position calculator ~130
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.
| Name | Type | Req | Description |
|---|---|---|---|
| entryPrice | number | – | Defaults to the live ask (long) or bid (short). |
| exitPrice | number | – | Target exit to evaluate. |
| leverage | integer | yes | – |
| marginUsd | number | yes | – |
| market | string | yes | Market symbol: BTC or ETH. |
| side | string | yes | long profits if price rises, short if it falls. |
No output schema declared.
No examples provided.
get_account Account ~71
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.
| Name | Type | Req | Description |
|---|---|---|---|
| wallet | string | – | Wallet address (0x...). Defaults to the connected wallet. |
No output schema declared.
No examples provided.
get_deposit_info Deposit instructions ~80
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.
| Name | Type | Req | Description |
|---|---|---|---|
| wallet | string | – | Wallet address (0x...). Defaults to the connected wallet. |
No output schema declared.
No examples provided.
get_intent_status Intent status ~56
Whether a submitted intent is still queued, has produced an open position, or is no longer pending.
| Name | Type | Req | Description |
|---|---|---|---|
| intentId | string | yes | – |
| wallet | string | – | Wallet address (0x...). Defaults to the connected wallet. |
No output schema declared.
No examples provided.
get_leaderboard Leaderboard ~92
Papertrade trader leaderboard for a time window, sortable by PnL, volume, balance and more. Search by name or address with q.
| Name | Type | Req | Description |
|---|---|---|---|
| page | integer | – | 0-based page; 25 rows per page. |
| q | string | – | Filter by leaderboard name or address. |
| sortDir | string | – | – |
| sortKey | string | – | – |
| window | string | – | – |
No output schema declared.
No examples provided.
get_liquidation_map Liquidation map ~55
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.
| Name | Type | Req | Description |
|---|---|---|---|
| market | string | yes | Market symbol: BTC or ETH. |
No output schema declared.
No examples provided.
get_markets Markets ~63
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_portfolio_history Portfolio history ~56
Equity curve for a wallet over 1h, 1d, 1w or all time.
| Name | Type | Req | Description |
|---|---|---|---|
| range | string | – | – |
| wallet | string | – | Wallet address (0x...). Defaults to the connected wallet. |
No output schema declared.
No examples provided.
get_price_chart Price chart ~71
OHLCV candles for BTC or ETH from Hyperliquid (the price source Papertrade settles against), with range stats and a TradingView link.
| Name | Type | Req | Description |
|---|---|---|---|
| count | integer | – | Number of candles. |
| interval | string | – | Candle interval. |
| market | string | yes | Market symbol: BTC or ETH. |
No output schema declared.
No examples provided.
get_protocol_stats Protocol stats ~63
Papertrade protocol analytics: TVL, margin, LP, lifetime volume, open positions, fees, PAPER supply and staking, plus daily history (volume, trader PnL, liquidations, users).
| Name | Type | Req | Description |
|---|---|---|---|
| days | integer | – | Days of daily history to include. |
No output schema declared.
No examples provided.
get_recent_trades Recent trades ~51
The latest opens, closes and liquidations across all of Papertrade, optionally filtered by market or wallet.
| Name | Type | Req | Description |
|---|---|---|---|
| market | string | – | Market symbol: BTC or ETH. |
| wallet | string | – | – |
No output schema declared.
No examples provided.
get_top_trades Top trades ~44
The most profitable individual Papertrade positions in a window: who, market, side, leverage, entry, exit and PnL.
| Name | Type | Req | Description |
|---|---|---|---|
| window | string | – | – |
No output schema declared.
No examples provided.
get_trade_history Trade history ~66
Closed and liquidated positions for a wallet, newest first, with entry, exit, settled PnL, fees and PAPER minted.
| Name | Type | Req | Description |
|---|---|---|---|
| pages | integer | – | Pages of 75 trades. |
| wallet | string | – | Wallet address (0x...). Defaults to the connected wallet. |
No output schema declared.
No examples provided.
get_trading_permissions Trading permissions ~47
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
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.
npm · papertrade-ai
claude mcp add nirholas-papertrade-ai -- npx -y papertrade-ai
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.