🤖 Give your AI assistant a paper-trading account

The Poshkan MCP server connects compatible AI assistants to a real-time paper-trading platform: live quotes, technical indicators, and broker-style order execution on US stocks, crypto, and leveraged forex — all with 100% virtual money.

Ask your assistant to analyze a chart and it can pull the candles itself. Ask it to act on the analysis and it can place the trade — a market order, a limit order at a better price, or a leveraged forex position with a stop-loss and take-profit attached. Because every dollar is virtual, it's a consequence-free sandbox for AI-assisted trading: strategy experiments, portfolio reviews, or a morning "check my positions" routine.

Things you can ask Claude

  • "Record my SPY / XLF / XLE hypothesis, strategy version, entry and exit rules, 3 trading-day hold and sizing before trading. Record no-trade decisions and append later reviews separately."
  • "Check BTC-USD on the 1-hour chart. If RSI is oversold near support, buy $2,000 worth on my crypto account."
  • "Review my stock account: what's my total P&L, and which holding looks weakest technically?"
  • "Open a EUR/USD short, 1 mini lot, stop-loss above the last swing high, take-profit at 2R."
  • "Place limit buys 3% below the current price on my whole watchlist, expiring end of day."
  • "List my open forex positions and close anything with more than $50 floating profit."

Setup — about two minutes

  1. Create a free Poshkan account (no card) and add a paper-trading account or two — stocks, crypto, or forex.
  2. Connect your client below.

Claude Desktop

Open Settings → Connectors → Add custom connector, name it Poshkan, and enter this URL:

https://www.poshkan.com/api/mcp/mcp

Claude opens Poshkan in your browser. Sign in and choose Allow access. No API key or desktop extension is needed.

Codex / ChatGPT desktop

In Poshkan, open the settings menu → AI/MCP access and create a token. Add a Streamable HTTP MCP server using this endpoint and the token as a bearer token:

https://www.poshkan.com/api/mcp/mcp
Authorization: Bearer pk_YOUR_TOKEN

Claude Code

claude mcp add poshkan --transport http "https://www.poshkan.com/api/mcp/mcp" \
  --header "Authorization: Bearer pk_YOUR_TOKEN"

OpenAI API and other MCP clients

It's a remote server over streamable HTTP — endpoint https://www.poshkan.com/api/mcp/mcp, authenticated with Authorization: Bearer pk_…. The OpenAI Responses and Agents APIs can pass the same token in their MCP authorization field.

OAuth-capable clients can connect directly without creating a personal token.

The 21 tools

Research & review (after the Neon research migration)

get_research_journal
Original research, no-trade decisions, separate reviews, linked executions and spot account net results. Omit account_id to read archived plans.
record_research
Preserve a server-timestamped hypothesis, strategy version, entry/exit conditions, holding days and sizing before execution. Does not trade.
review_research
Append a later review without rewriting the original plan.
link_research_transaction
Link a matching later execution to its prior plan; one plan per transaction.
set_execution_profile
Set future spot commission/fee, spread and adverse slippage assumptions for an account’s asset class. Fees can be zero.

Market data

get_quote
Live quote for a stock, ETF, crypto, or forex pair — price, day range, 52-week range.
get_price_history
OHLC candles with indicators: SMA20/50, RSI14, support/resistance, trend. Intraday to weekly.
search_symbols
Find tradeable tickers by name, filtered to stocks or crypto.

Accounts

list_accounts
All your paper accounts with type, cash, and holdings count.
get_account
One account in full: holdings priced live with P&L, pending orders, watchlist.
get_transactions
Recent buys, sells, deposits, and resets.

Stocks & crypto trading

trade
Paper spot buy/sell from a fresh server quote with account cost assumptions; returns fill, explicit fee, modeled price costs and execution ID. Reuse request_id on retries.
place_limit_order
Limit order that fills automatically when price reaches your level (GTC or DAY).
cancel_order
Cancel a pending limit order.

Leveraged positions

open_crypto_position
Guarded crypto long/short at 1–2×: mandatory stop/target, at least 3:1 planned reward/risk, max 0.5% cash risk, one position, and a timed exit. Supports dry runs.
open_forex_position
Open a leveraged long/short with optional stop-loss, take-profit, and timed auto-close.
list_forex_positions
Leveraged positions across markets with margin, SL/TP and deadlines, or recent closed positions with realized P&L.
close_forex_position
Close a position at the live rate and bank the P&L.
place_forex_entry_order
Pending entry that triggers when the rate hits your level — buy pullbacks, sell rallies.
list_forex_orders
Pending entry orders with triggers and expiry.
cancel_forex_order
Cancel a pending entry order.

Built to be safe to hand to an AI

  • Virtual money only. No deposits, no withdrawals, no broker connection — the worst case is a bruised virtual ego.
  • Server-side prices.Fills always use live market data fetched by the server at execution time; a confused model can't invent a fill price.
  • User-scoped access. OAuth connections and personal tokens are tied to your account, every call is checked against your paper accounts, and access can be revoked.
  • Real trading rules. Asset-class limits, margin requirements, stop-outs, and order validation are enforced by the same code that runs the app.

Frequently asked questions

Is any real money involved?
No. Poshkan is a paper-trading simulator — every account, balance, and trade is 100% virtual. AI assistants can practice strategies, but nothing real can be won or lost.
How does authentication work?
Claude Desktop uses a secure Poshkan OAuth sign-in and consent screen. Clients that accept bearer headers can instead use a personal API token (pk_…) from settings → AI/MCP access. Every connection is scoped to the signed-in user's paper accounts and can be revoked.
Which MCP clients are supported?
Claude Desktop and other OAuth-capable remote MCP clients can connect directly. Codex, Claude Code, the OpenAI API, and other Streamable HTTP clients can also connect with a Poshkan bearer token.
Can an AI make up fill prices?
No. Every trade is priced server-side from live market data at execution time, and order fills are claimed atomically. The assistant decides what to trade; Poshkan decides the price.
What does it cost?
Nothing. The account, the MCP server, and the market data are free — no card required.

Ready in two minutes

Create a free account, add the Poshkan URL to Claude, approve the secure sign-in — and ask it to check the markets.

Create a free account

Poshkan is a paper-trading simulator — all money, trades, and returns are 100% virtual, and nothing here is financial advice. Market data may be delayed or inaccurate.