Skip to content
Agentmart
Submit a tool

Papertrade AI

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

Connector by nirholas · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)Remote (HTTP)★ 4
Write a review

Install

Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/nirholas-papertrade-ai

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://papertrade-ai.ninabrekkerese.workers.dev/mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
15 read · 1 write · 2 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 18

Read from the source code; the running server may list different tools.

Read 15 · Look things up without changing anything.

  • calculate_position
  • get_account
  • get_deposit_info
  • get_intent_status
  • get_leaderboard
  • get_liquidation_map
  • get_markets
  • get_portfolio_history
  • get_price_chart
  • get_protocol_stats
  • get_recent_trades
  • get_top_trades
Show 3 more tools
  • get_trade_history
  • get_trading_permissions
  • preview_trade

Write 1 · Create, change, send or run things.

  • cancel_intent

Delete 2 · Delete, drop, revoke or wipe things.

  • close_positions
  • open_position

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • PAPERTRADE_PRIVATE_KEY

Other settings (environment variables or headers).

  • PAPERTRADE_WALLET

Network hosts it talks to 1

  • papertrade-ai.ninabrekkerese.workers.dev · found in remote endpoint, install command

Tools (18)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • calculate_positionPosition calculatorread-only

    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.

  • cancel_intentCancel intent

    Cancels a submitted intent that is still queued (not yet executed).

  • close_positionsClose positionscan change or delete data

    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 closing. Reports each settled result.

  • get_accountAccountread-only

    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.

  • get_deposit_infoDeposit instructionsread-only

    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.

  • get_intent_statusIntent statusread-only

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

  • get_leaderboardLeaderboardread-only

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

  • get_liquidation_mapLiquidation mapread-only

    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_marketsMarketsread-only

    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_portfolio_historyPortfolio historyread-only

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

  • get_price_chartPrice chartread-only

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

  • get_protocol_statsProtocol statsread-only

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

  • get_recent_tradesRecent tradesread-only

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

  • get_top_tradesTop tradesread-only

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

  • get_trade_historyTrade historyread-only

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

Show 3 more tools
  • get_trading_permissionsTrading permissionsread-only

    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.

  • open_positionOpen positioncan change or delete data

    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 identical market, side, margin and leverage, and only after the user explicitly confirmed. Waits for settlement and reports the fill.

  • preview_tradePreview traderead-only

    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 scenarios, and returns a quoteId valid for 3 minutes. Show the preview to the user and get an explicit yes before calling open_position with the quoteId.

Signals

Stars
4
Forks
0
Open issues
0
Last commit
Oct 10, 2026 (18 days ago)
Last release
Oct 10, 2026 (18 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.nirholas/papertrade-ai
Version
0.1.0
Auth
Auth not stated, API key
Packages
npm papertrade-ai
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026

More from nirholas

Cite this page

Papertrade AI MCP server. Agent Mart. https://agentmart.dev/connectors/nirholas-papertrade-ai (last updated 2026-10-24)