# papertrade-ai Trade Papertrade perps from any AI: Claude, ChatGPT, Codex, Cursor, Gemini, VS Code. Remote and local MCP server with non-custodial session keys, user-set guardrails and preview-then-confirm trading. - **Type:** MCP server - **Trust:** 60/100 (B), scored on the package rubric - **Verification:** community-indexed — nobody has claimed this listing - **Version:** 0.1.0 - **Author:** nirholas - **License:** MIT - **npm:** papertrade-ai - **Endpoints:** streamable-http https://papertrade-ai.ninabrekkerese.workers.dev/mcp - **Source:** https://github.com/nirholas/papertrade-ai - **Endpoint health:** reachable (last checked 2026-10-11T15:37:30.835Z, 1 sample) — uptime is not a security property and is not part of the trust score - **Compatible clients:** claude-code, cursor, copilot, chatgpt, gemini (basis: transport) ## Trust 60/100 (B), scored on the package rubric - Publisher verified: no - Install scripts: nothing suspicious found - Prompt-injection scan: not run - Obfuscation scan: not run - Evidence age: 0 days ## Security scan - **Status:** clean - **Scanned:** 2026-10-22T18:29:41.258Z - **Version scanned:** 0.1.0 - **CVEs:** none found by OSV at scan time ## Tools 18 declared. Statically extracted from the shipped source — a floor on the surface, not a census. - `get_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 an - `get_price_chart` — OHLCV candles for BTC or ETH from Hyperliquid (the price source Papertrade settles against), with range stats and a TradingView link. - `get_protocol_stats` — Papertrade protocol analytics: TVL, margin, LP, lifetime volume, open positions, fees, PAPER supply and staking, plus daily history (volume, trader PnL, liquida - `get_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 clust - `get_leaderboard` — Papertrade trader leaderboard for a time window, sortable by PnL, volume, balance and more. Search by name or address with q. - `get_top_trades` — The most profitable individual Papertrade positions in a window: who, market, side, leverage, entry, exit and PnL. - `get_recent_trades` — The latest opens, closes and liquidations across all of Papertrade, optionally filtered by market or wallet. - `get_account` — A Papertrade account: free balance, locked margin, equity, every open position with live estimated PnL, bust price and distance to liquidation, pending intents, - `get_trade_history` — Closed and liquidated positions for a wallet, newest first, with entry, exit, settled PnL, fees and PAPER minted. - `get_portfolio_history` — Equity curve for a wallet over 1h, 1d, 1w or all time. - `calculate_position` — 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% wi - `get_deposit_info` — 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 H - `get_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 - `preview_trade` — Step 1 of 2 for opening a position. Checks the trade against exchange limits, the account balance and the owner guardrails, estimates entry, bust price and PnL - `open_position` — Step 2 of 2: opens a real Papertrade position with the user's funds, signed by the delegated session key. Requires the quoteId from preview_trade for the identi - `close_positions` — Closes open positions at the market, signed by the session key. Pass positionIds, or all=true optionally narrowed by market. Confirm with the user before closin - `cancel_intent` — Cancels a submitted intent that is still queued (not yet executed). - `get_intent_status` — Whether a submitted intent is still queued, has produced an open position, or is no longer pending. ## Install **Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for. **Cautions** (coverage gaps and advisories — never blocking) - No publisher has proved control of this listing; it is indexed, not vouched for. **Config** (claude-code): ```json "{\n \"mcpServers\": {\n \"papertrade-ai\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"papertrade-ai\"\n ],\n \"env\": {\n \"PAPERTRADE_PRIVATE_KEY\": \"\"\n }\n }\n }\n}" ``` **Credentials it will ask for** (names only — Forge never holds a value): - `PAPERTRADE_PRIVATE_KEY` — Papertrade Private Key (optional) Placeholders only. Forge never holds, brokers, or transmits a credential value — replace each in your own config file. Do not send a value back to Forge; no Forge endpoint accepts one. - This entry needs 1 credential (0 required). The generated config carries placeholders, so it will fail in the editor rather than at runtime if they are left unset. ## Blast radius Moderate blast radius — runs locally and hosted; holds an api key. - Floor 26, ceiling 26 (tier: moderate) - This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score. ## Machine-readable views of this entry - Signed JSON: https://forgeregistry.com/api/v1/packages/papertrade-ai - Install plan: https://forgeregistry.com/api/v1/packages/papertrade-ai/install-plan - Alternatives: https://forgeregistry.com/api/v1/alternatives/papertrade-ai - HTML page: https://forgeregistry.com/registry/papertrade-ai - MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan` ## About this document Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.