🤖 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
- Create a free Poshkan account (no card) and add a paper-trading account or two — stocks, crypto, or forex.
- 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/mcpClaude 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_TOKENClaude 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 accountPoshkan 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.