papertrade-ai

MCPcommunitylive
v0.1.0nirholasMITUpdated 12d agonpmGitHub

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.

Endpoint healthlive
checked 11 days ago · 293ms · auth required
100% of the last 1 check reached this endpoint
Works in
ClaudeCursorCopilotChatGPTGemini

Inferred from the transports this listing declares (stdio, streamable-http). A client not listed here hasn’t been ruled out — it just isn’t something Forge can confirm.

Automatically indexed from public sources. Not yet verified by the developer on Forge.Claim this listing →
66Downloads/wk
3GitHub stars
12d agoLast update
Reads these credentials
  • PAPERTRADE_PRIVATE_KEYAPI keyoptional

    Optional wallet key for headless trading. Only used to sign a session key registration; never stored.

Declared by the author in the official MCP registry. Forge does not store, broker, or ever see these values — the config below is scaffolded with placeholders you fill in locally.

Package
Authornirholas
LicenseMIT
Version0.1.0
Sourcenpm+mcp-registry
Trust Status
B
60/100Good
✓Listed in Forge index+10/10
—Publisher identity verified+0/20
→ Publisher: run `forge publish` from the package repo to claim ownership
—Ed25519 publish signature+0/5
→ Included automatically when the publisher runs `forge publish`
—Domain verification+0/5
→ Publisher: host /.well-known/forge.json on the package homepage with { "publisher": "<github-login>" }
—npm Trusted Publishing (Sigstore)+0/5
→ Publish from GitHub Actions with --provenance so the attestation binds this package to this repo
—npm maintainer match+0/5
→ Earned once your identity is verified above and that login is an npm maintainer of this package
✓CVE scan · clean+30/30
✓Static analysis · clean+20/20
Paste into Claude Code, Cursor, or any AI assistant to fix all gaps
StatusCommunity-indexed
PublisherUnverified
SignatureUnsigned
Domain—
Provenance—
Dependencies✓ 21 resolved · none vulnerable
Tool surface18 tools · none privileged
Security scan✓ Cleanv0.1.0 · todayHow well does this scan work?
EvalsNone
IndexedOct 11, 2026

Verification confirms publisher identity (repo ownership), not code safety. The security scan covers known CVEs and suspicious install scripts.

Tools

18 tools · none privileged
Statically extracted from the published packagev0.1.0 · 3h ago

Read out of the source npm actually ships, at scan time. The package was never executed. Tools registered dynamically at runtime, or hidden inside bundled or minified code, can be missed — so this is a floor on the tool surface, not a complete census of it.

get_marketsLive 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.

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.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

get_liquidation_mapWhere open Papertrade positions get liquidated: notional and position count of longs and shorts by price bucket around the current price, with the largest clusters.

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.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

get_accountA 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.

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.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

calculate_positionPure 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.

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.

No input schema was published for this tool.

get_deposit_infoHow 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.

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.

No input schema was published for this tool.

get_trading_permissionsWhat 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.

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.

No input schema was published for this tool.

preview_tradeStep 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 wit…

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 wit…

No input schema was published for this tool.

open_positionStep 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.

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.

No input schema was published for this tool.

close_positionsCloses 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.

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.

No input schema was published for this tool.

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

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

No input schema was published for this tool.

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

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

No input schema was published for this tool.

18 of 18 tools published a description.

Tool names and descriptions are written by the publisher and shown verbatim as inert text. They are the strings an MCP client passes to a model, so Forge scans them for prompt-injection patterns — any finding appears with the security scan above. “Privileged” is a keyword match on the tool name, not an audit of what the tool does: a benign-sounding name can still do anything.

About

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.

Keywords
papertrademcpmcp-servermodel-context-protocolperpsperpetual-futureshyperliquidhyperevmtradingcrypto-tradingai-agentclaudechatgptcodexcursorgemini-clivscodeoauth
Alternatives
Comparing tool surfaces…

Dependency tree

What one Forge scan resolved from npm metadata on 2026-10-22 — observed resolution, not a publisher declaration.

21 packages resolved · 5 direct · none carrying advisories Resolution stops at depth 4 and 60 packages.

Not followed: peerDependencies. This tree covers runtime dependencies only, so anything those pull in was never resolved.

Topics

Related in finance & trading