# Papertrade AI

> Papertrade AI is an open-source MCP server for finance and payments. Trade BTC and ETH perps on Papertrade from an AI client, within limits you set. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://papertrade-ai.ninabrekkerese.workers.dev
- **Repository:** https://github.com/nirholas/papertrade-ai
- **MCP Registry name:** io.github.nirholas/papertrade-ai
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

Trading goes through two calls. The first previews entry price, liquidation price and PnL scenarios for the exact order; the second needs a signed quote for that identical trade, valid for three minutes. A wallet signature registers a 30-day session key that can open, close and cancel positions but cannot withdraw or transfer funds, and the server checks margin, leverage, rolling 24-hour size, open positions and markets before anything is signed.

There is a read-only mode that needs only a wallet address, so an assistant can pull live markets, liquidation maps, leaderboards and wallet analytics without any signing. The site advertises up to 1000x leverage with a $10 minimum margin and a $10K minimum size, so the guardrails matter: you choose a per-trade margin cap, a leverage cap and a daily size cap.

It runs as a remote OAuth 2.1 server on a Cloudflare Workers address or locally over stdio with npx, and it is MIT-licensed.

## Features

- **Preview then confirm:** Opening a position takes two calls, and the second needs a signed quote for the identical trade.
- **Withdraw-proof session keys:** The session key can open, close and cancel positions but cannot withdraw or transfer anything.
- **Server-side guardrails:** Margin, leverage, rolling 24h size, open positions and allowed markets are checked in code before an intent is signed.
- **Market and wallet analytics:** Reads live BTC and ETH markets, liquidation maps, top traders and per-wallet win rate and equity curve.
- **Read-only mode:** A wallet address alone gives read access with no login.
- **Remote or local:** Use the hosted OAuth endpoint or run it over stdio with npx.

## Good for

- Check liquidation price and PnL scenarios before opening a leveraged position
- Ask which wallets are top traders this week and what they hold
- Analyze one wallet's win rate, biggest trade and equity curve
- Close all BTC positions with a spoken-style request
- Let an assistant trade only inside a daily size limit you set

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

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

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "papertrade-ai": {
      "url": "https://papertrade-ai.ninabrekkerese.workers.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "papertrade-ai": {
      "serverUrl": "https://papertrade-ai.ninabrekkerese.workers.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## FAQ

### Can the AI withdraw my funds?

No. The session key can open, close and cancel positions, but the exchange contract does not let it withdraw or transfer anything.

### How do I revoke access?

Sign in on the account page and revoke any connected app; its tokens and keys are deleted immediately.

### Does it need an API key?

No for the hosted server, which uses OAuth. The local package optionally reads a wallet address, or a private key for headless trading that is only used to sign the session-key registration.

### Which clients work?

Claude, ChatGPT, Codex, Cursor, Gemini CLI, VS Code and other MCP clients.

### What licence is it under?

MIT.

### Is Papertrade AI free?

Yes. Papertrade AI is open source, so you can use and self-host it for free.

### How do I add Papertrade AI to Claude Code?

Run this command in your terminal: claude mcp add --transport http papertrade-ai https://papertrade-ai.ninabrekkerese.workers.dev/mcp

### What are the best alternatives to Papertrade AI?

The closest alternatives to Papertrade AI are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

## Alternatives

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/papertrade-ai
