Papertrade AI

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

ماذا يمكنك أن تفعل مع Papertrade AI؟

"What are BTC and ETH doing on Papertrade right now?"
"Show me the Papertrade liquidation map for ETH."
"Who are the top 10 Papertrade traders this week? What are they holding?"
"Analyze wallet 0x...: win rate, biggest trade, equity curve."
"If I long BTC with $20 at 500x, where is my liquidation price?"
"Preview a $15 ETH short at 800x, then open it if I confirm."
"Close all my BTC positions."

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)

Claude Code

claude mcp add --transport http papertrade-ai 'https://papertrade-ai.ninabrekkerese.workers.dev/mcp'

إعداد JSON (Claude Desktop وCursor وVS Code)

{
    "mcpServers": {
        "papertrade-ai": {
            "type": "http",
            "url": "https://papertrade-ai.ninabrekkerese.workers.dev/mcp"
        }
    }
}

NPM package papertrade-ai

Claude Code

claude mcp add papertrade-ai -e 'PAPERTRADE_WALLET=<PAPERTRADE_WALLET>' -e 'PAPERTRADE_PRIVATE_KEY=<your papertrade_private_key>' -- npx -y papertrade-ai@0.1.0

إعداد JSON (Claude Desktop وCursor وVS Code)

{
    "mcpServers": {
        "papertrade-ai": {
            "command": "npx",
            "args": [
                "-y",
                "papertrade-ai@0.1.0"
            ],
            "env": {
                "PAPERTRADE_WALLET": "<PAPERTRADE_WALLET>",
                "PAPERTRADE_PRIVATE_KEY": "<your papertrade_private_key>"
            }
        }
    }
}

متغيرات البيئة

PAPERTRADE_WALLET Wallet address for read-only access without logging in.
PAPERTRADE_PRIVATE_KEY سري Optional wallet key for headless trading. Only used to sign a session key registration; never stored.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات

Papertrade AI
What you can ask
Install
Tools
Security
Develop and self-host
Risk
License
Support the project
Built for AI agents too
More from the same author
Contributors
Star history

Papertrade AI

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

Open-source Model Context Protocol server with live markets, wallet analytics, liquidation maps, and guarded trading through non-custodial session keys.

Website · Docs · Tools · Security · REST API

https://papertrade-ai.ninabrekkerese.workers.dev/mcp

One URL, OAuth 2.1, no API keys. Your wallet signs once to register a session key that can trade but cannot withdraw, and the server enforces the limits you choose: margin per trade, leverage, daily size, open positions and markets. Every trade is previewed and needs your confirmation.

What you can ask

"What are BTC and ETH doing on Papertrade right now?"
"Show me the Papertrade liquidation map for ETH."
"Who are the top 10 Papertrade traders this week? What are they holding?"
"Analyze wallet 0x...: win rate, biggest trade, equity curve."
"If I long BTC with $20 at 500x, where is my liquidation price?"
"Preview a $15 ETH short at 800x, then open it if I confirm."
"Close all my BTC positions."

On clients with MCP Apps support (Claude, ChatGPT, VS Code, Goose) results render as an interactive trading card with a live chart.

Install

Client	Install
Claude (web, desktop, mobile)	Settings, Connectors, Add custom connector, paste `https://papertrade-ai.ninabrekkerese.workers.dev/mcp`. Guide
Claude Code	`/plugin marketplace add nirholas/papertrade-ai` then `/plugin install papertrade-ai@papertrade-ai`, or `claude mcp add --transport http papertrade https://papertrade-ai.ninabrekkerese.workers.dev/mcp` Guide
ChatGPT	Settings, Apps, Advanced settings, Developer mode, Create app, paste the URL, OAuth. Guide
OpenAI Codex	`codex mcp add papertrade --url https://papertrade-ai.ninabrekkerese.workers.dev/mcp` then `codex mcp login papertrade` Guide
Cursor	One-click install Guide
VS Code (Copilot)	One-click install or `code --add-mcp '{"name":"papertrade","type":"http","url":"https://papertrade-ai.ninabrekkerese.workers.dev/mcp"}'` Guide
Gemini CLI	`gemini extensions install https://github.com/nirholas/papertrade-ai` Guide
Claude Desktop (local)	Download `papertrade-ai.mcpb` from Releases and open it.
Windsurf, Zed, Cline, Goose, LibreChat, others	Streamable HTTP URL above, or stdio `npx -y papertrade-ai`. Guide

Local (stdio)

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

Run npx -y papertrade-ai login once to connect a wallet in your browser. Credentials stay in ~/.config/papertrade-ai (mode 0600). CLI guide

Tools

Tool	Access	What it does
`get_markets`	public	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.
`get_price_chart`	public	OHLCV candles for BTC or ETH from Hyperliquid (the price source Papertrade settles against), with range stats and a TradingView link.
`get_protocol_stats`	public	Papertrade protocol analytics: TVL, margin, LP, lifetime volume, open positions, fees, PAPER supply and staking, plus daily history (volume, trader PnL, liquidations, users).
`get_liquidation_map`	public	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.
`get_leaderboard`	public	Papertrade trader leaderboard for a time window, sortable by PnL, volume, balance and more.
`get_top_trades`	public	The most profitable individual Papertrade positions in a window: who, market, side, leverage, entry, exit and PnL.
`get_recent_trades`	public	The latest opens, closes and liquidations across all of Papertrade, optionally filtered by market or wallet.
`get_account`	public	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.
`get_trade_history`	public	Closed and liquidated positions for a wallet, newest first, with entry, exit, settled PnL, fees and PAPER minted.
`get_portfolio_history`	public	Equity curve for a wallet over 1h, 1d, 1w or all time.
`calculate_position`	public	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).
`get_deposit_info`	public	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.
`get_trading_permissions`	public	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.
`preview_trade`	trading	Step 1 of 2 for opening a position.
`open_position`	trading	Step 2 of 2: opens a real Papertrade position with the user's funds, signed by the delegated session key.
`close_positions`	trading	Closes open positions at the market, signed by the session key.
`cancel_intent`	trading	Cancels a submitted intent that is still queued (not yet executed).
`get_intent_status`	public	Whether a submitted intent is still queued, has produced an open position, or is no longer pending.

Full inputs and annotations: Tool reference. Public tools also work over plain HTTPS:

curl https://papertrade-ai.ninabrekkerese.workers.dev/api/v1/tools/get_markets
curl "https://papertrade-ai.ninabrekkerese.workers.dev/api/v1/tools/get_liquidation_map?market=ETH"

OpenAPI 3.1 at /openapi.json, ready for GPT Actions and agent frameworks. Unauthenticated MCP for read-only agents: https://papertrade-ai.ninabrekkerese.workers.dev/public/mcp.

Security

Non-custodial. Your wallet signs one EIP-712 RegisterSessionKey message, the same one the official Papertrade app signs for one-click trading. The session key is scoped by the exchange contract to open, close and cancel. It cannot withdraw or transfer.
Guardrails in code, not in the prompt. Margin per trade, leverage, rolling 24h position size, open positions and markets are checked on the server before any intent is signed.
Preview, then confirm. open_position needs a signed quote from preview_trade for the identical trade, valid for 3 minutes.
Encrypted per app. Each app's session key is encrypted with a key derived from that app's own access token.
Revoke in one click at /account.

Read the full security model. Report vulnerabilities privately: SECURITY.md.

Develop and self-host

git clone https://github.com/nirholas/papertrade-ai && cd papertrade-ai
npm install
npm test           # unit tests
npm run dev        # local Worker on http://127.0.0.1:8787

Deploy your own copy to Cloudflare Workers with one KV namespace and one secret: Self-hosting. The package also exports the tool registry, policy engine and intent signing for use in your own agent: import { TOOLS, runTool } from 'papertrade-ai'.

Path	What
`src/tools/registry.ts`	Every tool: schema, annotations, implementation
`src/core/`	Papertrade API client, EIP-712 intents, bust price math
`src/worker/`	Cloudflare Worker: OAuth provider, MCP, REST, pages
`src/cli.ts`	stdio server and `login` CLI
`src/web/`	MCP Apps widget, connect and account pages
`docs/`	Documentation (rendered to the website)
`scripts/build-site.mjs`	Website, `llms.txt`, sitemap, discovery files, manifests

Risk

Papertrade positions use real USDC. At 1000x leverage a 0.1% move against you liquidates the position and the full margin is lost. Papertrade AI is independent open-source software, not affiliated with Papertrade, and not financial advice.

License

MIT

Support the project

If papertrade-ai saves you time, star it on GitHub. Stars are how other developers and AI agents find the repositories worth trusting, and they cost you one click.

Know someone who would use it? Post on X · Share on Bluesky · Share on LinkedIn · Submit to Hacker News · Share on Reddit

Built for AI agents too

Coding agents and LLM tooling can read this repo directly: AGENTS.md, llms.txt, llms-full.txt. Point an agent at https://github.com/nirholas/papertrade-ai and it has the context it needs.

Contributors

Star history

الأسئلة الشائعة

ما هو Papertrade AI؟

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

كيف أثبّت Papertrade AI؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http papertrade-ai 'https://papertrade-ai.ninabrekkerese.workers.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Papertrade AI إلى مفتاح API؟

نعم. يتطلب PAPERTRADE_PRIVATE_KEY، وتضبطها في إعداداته.

هل Papertrade AI مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Papertrade AI؟

ينشره nirholas. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.

تفاصيل الخادم

مُدرج في: سجل MCP الرسمي
الناشر: nirholas
الفئة: الذكاء الاصطناعي والوكلاء
طريقة التشغيل: بعيد + محلي
نجوم GitHub: ★ 4
الترخيص: MIT
لغة البرمجة: TypeScript
آخر تحديث للشيفرة: ١٠‏/١٠‏/٢٠٢٦
المشكلات المفتوحة: 3
الإصدار: 0.1.0
نُشر في: ١٠‏/١٠‏/٢٠٢٦

io.github.nirholas/papertrade-ai

خوادم مشابهة

Red Thread (牵线) AI-native intro network: your AI finds people who want to meet you. Double opt-in.
Knot Shared memory across ChatGPT, Claude, Cursor, and Gemini. OAuth 2.1 context & supersess...
Knot Shared memory across ChatGPT, Claude, Cursor, and Gemini. OAuth 2.1 context & supersess...
Geistra Shared memory for your AI apps: Spaces of records, files and plans you and others can w...
NexusWindows for Claude Windows computer use in the background: UI Automation and Win32 messages, every action ...
Remote Desktop Commander Remote Desktop Commander: use files, terminal and processes on your own computers from ...
Nido - VM Manager for AI Agents Local QEMU VM manager with opt-in MCP event subscriptions for AI agents.
Forgejo / Codeberg / Gitea Model Context Protocol server for Forgejo, Codeberg and Gitea, in Rust

الذكاء الاصطناعي والوكلاء

Papertrade AI

ماذا يمكنك أن تفعل مع Papertrade AI؟

التثبيت

التوثيق

Papertrade AI

What you can ask

Install

Local (stdio)

Tools

Security

Develop and self-host

Risk

License

Support the project

Built for AI agents too

More from the same author

Contributors

Star history

الأسئلة الشائعة