TradeStaq MCP
OfficialThis server provides AI-powered crypto trading via MCP: authenticate, inspect markets/portfolio, create/backtest strategies, deploy/manage bots, review performance, and copy traders.
Authenticate with TradeStaq (email/password, browser OAuth, token setup, logout) and connect exchanges.
View market data: prices, OHLCV candles, exchange accounts, market search, and create paper-trading exchanges.
Inspect portfolio balance, open positions, and live PnL.
Browse, explain, compare, create, and AI-generate trading strategies.
Run historical backtests, check results, and export backtest CSV/PDF links.
List, deploy, stop, and monitor trading bots; close positions and export bot trade history.
Review closed trade history and performance metrics like ROI, win rate, PnL, and Sortino ratio.
Browse top traders and follow them for copy trading.
Get personalized strategy suggestions and market context such as trend, volatility, and support/resistance.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TradeStaq MCP Show me my portfolio"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
TradeStaq MCP Server
Website · Docs · MCP / AI Tools · Pricing
46 AI-powered trading tools for Claude, Cursor, and any MCP client.
Create strategies, backtest them, deploy trading bots, copy top traders, monitor positions, and manage your crypto portfolio, all from conversation. Supports Binance, Bybit, OKX, Bitget, Hyperliquid, dYdX, and more.
"Show me my portfolio" → get_portfolio
"Backtest GhostRider on BTC/USDT for 3 months" → what_if_backtest
"Deploy it on my Binance account" → deploy_bot
"Who are the top traders this month?" → list_top_traders
"Generate a momentum strategy for ETH" → generate_strategyQuick Start
Option A: Remote server (no install needed)
For MCP clients that support HTTP transport:
{
"mcpServers": {
"tradestaq": {
"url": "https://mcp.tradestaq.com/mcp"
}
}
}Option B: npx (recommended for local)
No clone, no build. Just add to your MCP config:
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"tradestaq": {
"command": "npx",
"args": ["-y", "@the-staq/tradestaq-mcp"]
}
}
}Cursor (.cursor/mcp.json):
{
"mcpServers": {
"tradestaq": {
"command": "npx",
"args": ["-y", "@the-staq/tradestaq-mcp"]
}
}
}Claude Code:
claude mcp add tradestaq -- npx -y @the-staq/tradestaq-mcpOption C: Clone and build
git clone https://github.com/the-staq/tradestaq-mcp.git
cd tradestaq-mcp
npm install
npm run buildThen point your MCP client to dist/index.js.
Related MCP server: Trading MCP Server
Authenticate
After adding the server, ask your AI assistant to log in:
"Log me in to TradeStaq" — uses email/password directly
"Authenticate with TradeStaq" — opens a browser window for secure OAuth login
Credentials never enter the chat when using the browser flow. Token is stored locally at ~/.tradestaq/mcp-config.json with restricted permissions (0600).
Tools
Auth
Tool | Description |
| Log in with email and password |
| Log in via browser (OAuth + PKCE) |
| Check authentication status |
| Manually set a JWT token |
| Connect an exchange account via browser |
| Remove stored credentials |
Market Data
Tool | Description |
| Current price, 24h change, volume |
| OHLCV candlestick data (1m to 1d) |
| List connected exchange accounts |
| Find trading pairs on a specific exchange |
Portfolio
Tool | Description |
| Total balance, exchanges, active bots |
| Open positions with live PnL |
Strategies
Tool | Description |
| Browse marketplace or your own strategies |
| Full strategy details and performance |
| Plain-English explanation with risk profile |
| Side-by-side metrics comparison |
| Create a strategy from TradeDroid code |
| Generate a strategy from natural language using AI |
Backtesting
Tool | Description |
| Run a historical backtest (async, 30-120s) |
| Check status of a running backtest |
Bot Management
Tool | Description |
| All bots with status and performance |
| Detailed bot metrics and config |
| Run-by-run history: why a bot did or did not trade, dropped signals, errors |
| Deploy a strategy as a trading bot |
| Edit a bot: rename, switch strategy or apply a preset, timeframe, execution mode, strategy parameters, version channel, risk settings, notifications, |
| Start a paused or stopped bot |
| Stop a running bot now (open positions are left unmanaged) |
| Delete a bot (refused while it has an open trade) |
| Close an open position (full or partial) |
| A bot's public chart links (tradestaq.com/chart/...) |
| Make a public link to a bot's live chart (choose expiry and whether PnL shows) |
| Turn a public chart link off |
deploy_bot defaults to paper trading. Pass live: true for real money. The bot trades on the strategy's own timeframe; pass timeframe (e.g. 4h) only to override it. Leave out name and the server names the bot. The bot starts trading as soon as it is created, so give it its settings in the same call: presetId (a preset's ID or slug, of the same strategy), parameterOverrides and executionMode; the server applies them in the create itself (with a preset the bot is created paused, then started). strategyId takes an ID or a slug. start: false creates it paused for start_bot.
update_bot sends everything you pass in one update, after merging it onto the bot's current settings (position sizing, spin settings and parameter overrides are never wiped by a partial change). Size and leverage change only when you pass them. strategyId and presetId take an ID or a slug (trade-wind, trade-wind-long-short). A strategy or timeframe change needs the bot to be flat: pause it with stopAfterClose: true first, wait until get_bot_status shows no open position, then switch, then start_bot. A live bot needs the mcp:live scope for any change; a paper bot mcp:paper. The reply is the resulting config (strategy, version, timeframe, mode, overrides, size, leverage, status) plus server warnings.
For example, switching a paused 15m GhostRider bot to Trade Wind on 4h with its Long & Short preset, and renaming it:
{ "id": "6ab7c2d60014ba19b0c54258", "presetId": "trade-wind-long-short", "timeframe": "4h", "name": "Trade Wind · SUI · 4h" }Trade History
Tool | Description |
| Closed trades, one row per close: direction, entry/exit prices, PnL, return on position size |
| ROI, win rate, Sortino ratio, PnL breakdown |
Copy Trading
Tool | Description |
| Browse the leaderboard of top traders |
| Subscribe to copy a trader's trades |
Advisor
Tool | Description |
| Match strategies to your risk profile |
| Trend, volatility, support/resistance for a symbol |
Prompt Templates
Trading Assistant — Start a conversation about your portfolio and positions. The AI calls get_portfolio and get_positions to ground its responses in your actual data.
Strategy Builder — Walk through creating, backtesting, and deploying a strategy. Pass an optional goal like "momentum strategy for ETH" to get focused suggestions.
Portfolio Reviewer — Deep analysis of your portfolio, positions, trade history, and performance. Identifies what's working, what isn't, and suggests improvements.
Resources
MCP resources provide browsable data that AI clients can read directly:
Resource | URI | Description |
Portfolio |
| Balances, positions, and active bots |
Bots |
| All bots with status and PnL |
Strategies |
| Strategy catalog with ratings |
Architecture
stdio HTTPS
┌──────────────┐◄──────────►┐ ┌────────────────►┌──────────────┐
│Claude Desktop│ │ │ │ │
│Cursor / CLI │ │ tradestaq-mcp │ Bearer JWT │ TradeStaq │
└──────────────┘ │ 46 tools │◄────────────────│ API │
│ 3 prompts │ │ │
┌──────────────┐ HTTP+SSE │ 3 resources │ └──────────────┘
│ Any MCP │◄──────────►│ │
│ client (web) │ └──────────────────┘
└──────────────┘Two transports: stdio (local, default) and HTTP+SSE (remote,
--httpflag)Hosted at
https://mcp.tradestaq.com/mcpfor remote clientsJWT auth via OAuth PKCE or email/password login
All tools return structured JSON with error contract
Token auto-refresh before the access token expires. Several local copies (say an interactive session plus headless
claude -pruns) can share one sign-in: they refresh one at a time under a lockfile next to~/.tradestaq/mcp-config.json, and a copy whose tokens another one rotated picks up the new pair from the file
Development
npm run dev # watch mode with tsx
npm run build # compile TypeScript
npm run lint # type check without emitting
npm test # run tests
npm start # run server (stdio)
npm run start:http # run server (HTTP+SSE on port 3100)Releasing
npm run release:patch # or release:minor / release:majorThis bumps the version (and the server.json versions), files the CHANGELOG's
[Unreleased] notes under it, commits, tags vX.Y.Z and pushes. The tag triggers
.github/workflows/publish.yml:
Approve the run. The publish job waits in the
npmenvironment for a maintainer's approval (Actions, then the run, then Review deployments).It type-checks, tests and publishes to npm through trusted publishing (no npm token anywhere), with provenance.
It updates the listing on the official MCP Registry.
Then run the Deploy MCP workflow to update the hosted server at mcp.tradestaq.com.
Error Handling
All tool errors return structured responses:
{
"error": {
"code": "INSUFFICIENT_BALANCE",
"message": "Human-readable description",
"retryable": true,
"retryAfterMs": 5000
}
}Error codes: AUTH_EXPIRED, TIMEOUT, RATE_LIMITED, NETWORK_ERROR, HTTP_4xx, HTTP_5xx.
Security
Credentials never enter AI conversation history
OAuth PKCE flow with browser-based authentication
Token stored with 0600 file permissions
Localhost-only OAuth callbacks
deploy_bot,stop_bot,close_position, andfollow_traderare destructive operations (AI confirms with user)
Links
Website: tradestaq.com
Documentation: tradestaq.com/docs
MCP & AI trading tools: tradestaq.com/mcp
Pricing: tradestaq.com/pricing
npm package: @the-staq/tradestaq-mcp
License
MIT
Available Tools
34 toolsauthenticateA
Log in to TradeStaq via browser. Opens a login page in your browser — you authenticate there and the token is saved automatically. No credentials enter the chat.
Scope controls what the agent can do: "mcp:read" (view-only research agents), "mcp:paper" (paper-trade bots, safe default — cannot touch live money), "mcp:live" (full access including live-money deploys, live exchange connections, and wallet charges). Scopes are hierarchical: live implies paper implies read. When in doubt, pick paper first — the server returns 403 insufficient_scope if the agent tries a live action, and the user can always re-authorize with a broader scope.
Inputs: scope.
check_authA
Preflight check before invoking other tools. Returns the authenticated user, OAuth scope on the current token (mcp:read / mcp:paper / mcp:live), tier capabilities (allowLiveTrading, allowAIBuilder, allowNewsTrading, allowMcpServer), Strategy Lab wallet balance (for cost-charging tools like generate_strategy), and the OAuth client name/expiry. Agents should call this at the start of a workflow to pick the narrowest scope needed and to surface cost/balance to the user before committing to a charge. Response is cached server-side for 30s per token.
Inputs: no named parameters.
close_positionB
Close an open trading position. WARNING: This executes a market order to close your position.
Inputs: symbol (required), tradeId (required), exchangeId (required), percentage.
compare_strategiesC
Compare multiple strategies side by side on key metrics.
Inputs: ids (required).
connect_exchangeA
Connect a new exchange account via browser. Opens a page where you securely enter your exchange API keys. Keys never enter the chat.
Inputs: no named parameters.
create_paper_exchangeA
Create a paper-trading exchange with a simulated balance. No API keys required. Paper exchanges let agents test strategies, deploy bots, and place trades without risking real money. Recommended starting point for first-time users and any scope=mcp:paper workflow.
Requires OAuth scope mcp:paper or mcp:live. Session-cookie users (dashboard) can always call this.
Inputs: platform (required), accountLabel, exchangeType, initialBalanceUsdt.
create_strategyC
Create a new trading strategy from TradeDroid code.
Inputs: code (required), name (required), market, timeframe, +1 more.
deploy_botA
Deploy a strategy as a trading bot. Defaults to paper trading for safety.
Inputs: exchangeId (required), strategyId (required), live, name, +4 more.
explain_strategyA
Get a plain-English explanation of a strategy: what it does, risk profile, best market conditions.
Inputs: id (required).
export_backtestA
Get export links for a completed backtest. Returns CSV and PDF download URLs.
Inputs: id (required).
export_bot_tradesB
Export a bot's trade history as structured data. Returns all trades with PnL, entry/exit prices, and performance summary.
Inputs: id (required), format.
follow_traderA
Subscribe to copy a top trader's trades. WARNING: This commits capital to copy trading.
Inputs: masterId (required), exchangeId (required), multiplier.
generate_strategyB
Generate a trading strategy from a natural language description using AI. Describe what you want and AI creates the TradeDroid code.
Inputs: description (required), market, timeframe.
get_backtest_resultsA
Check status/results of a previously started backtest.
Inputs: jobId (required).
get_bot_statusC
Get detailed status and performance for a specific bot.
Inputs: id (required).
get_candlesC
Get OHLCV candlestick data for a trading pair.
Inputs: symbol (required), limit, exchange, timeframe.
get_market_contextB
Get market context for a symbol: trend direction, volatility level, support/resistance levels.
Inputs: symbol (required), exchangeId (required), timeframe.
get_performance_metricsB
Get trading performance metrics: ROI, win rate, PnL, Sortino ratio.
Inputs: timeRange, tradeType, exchangeId.
get_portfolioA
Get portfolio overview: total balance, exchanges, and active bots.
Inputs: no named parameters.
get_positionsA
Get all open trading positions with current PnL.
Inputs: exchange.
get_priceB
Get the current price of a trading pair (e.g. BTC/USDT).
Inputs: symbol (required), exchange.
get_strategyB
Get detailed info about a specific strategy.
Inputs: id (required).
get_trade_historyB
Get your closed trade history with PnL, entry/exit prices, and duration.
Inputs: page, limit, symbol, exchange.
list_botsA
List all your trading bots with status and performance.
Inputs: no named parameters.
list_exchangesA
List your connected exchange accounts with their IDs, platform names, and status.
Inputs: no named parameters.
list_strategiesB
List available trading strategies.
Inputs: owned.
list_top_tradersA
Browse the leaderboard of top-performing traders you can copy.
Inputs: limit, period, sortBy.
loginB
Log in to TradeStaq with email and password.
Inputs: email (required), password (required).
logoutB
Remove stored TradeStaq credentials.
Inputs: no named parameters.
search_marketsA
Search for trading pairs on a specific exchange. Use list_exchanges to find your exchange IDs.
Inputs: query (required), exchange (required).
set_tokenC
Manually set a JWT token. For advanced use only.
Inputs: token (required), baseUrl.
stop_botB
Stop a running trading bot. Open positions remain.
Inputs: id (required).
suggest_strategiesA
Suggest trading strategies matching your risk profile. Filters by risk tolerance, max drawdown, preferred assets, and minimum Sharpe ratio.
Inputs: minSharpe, maxDrawdown, riskTolerance, preferredAssets.
what_if_backtestA
Run a backtest on a strategy. Async, may take 30-120 seconds. Returns full performance metrics.
Inputs: exchange (required), strategyId (required), period, symbol, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 34 tools
Most tools have clearly distinct purposes, with only minor overlap among auth-related tools (authenticate, login, set_token) and portfolio vs positions vs trade history. Descriptions are sufficiently detailed to resolve ambiguity.
Tool names consistently follow the verb_noun pattern (e.g., close_position, create_strategy, list_bots). Only login/logout deviate, but that's standard for auth verbs. The pattern is predictable and uniform.
34 tools is above the typical 3-15 range for a well-scoped server. While the domain is broad (strategy management, backtesting, bots, portfolio, copy trading), the number feels heavy and may overwhelm agents.
The tool surface covers core trading workflows but lacks update and delete operations for strategies and bots. Create and deploy are present, but modifications and deletions are absent, creating notable gaps.
Maintenance
Related MCP Connectors
Trade Papertrade BTC and ETH perps from Claude, ChatGPT, Codex, Cursor and any MCP client.
Free crypto-futures paper trading and live market data for AI agents. 31 tools; no key for data.
Trade 16 crypto exchanges + MetaTrader 5 from your AI assistant via one MCP connection.
> TradingMCP puts a market analyst inside your AI assistant. Paste one URL into Claude, ChatGPT, Cursor, VS Code or any MCP client and ask in plain language: screen for breakouts, run a multi-timeframe analysis, backtest a strategy with walk-forward validation, scan for smart-money and volume signals, or get a one-prompt morning market brief. In clients that support MCP Apps, price charts and the Markets panel are drawn right in the chat. > 40+ tools covering crypto (real-time), stocks, ETFs, FX, futures and commodities across major global exchanges. > Hosted, nothing to install: Pro $9/month (2,500 tool calls) or Pro+ $29/month (10,000). Paid upfront with a 14-day money-back guarantee; your API key arrives right after checkout. > Built on the open-source tradingview-mcp core (MIT, ~5k GitHub stars): self-host it free, or use the hosted version with zero ops. > For research and education, not financial advice. Not affiliated with TradingView
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to perform cryptocurrency trading analysis and execution with 38+ tools including real-time market data, technical indicators, risk management, and support for both paper trading and live execution on Hyperliquid.7MIT
- AlicenseBqualityDmaintenanceProvides a comprehensive suite of 20 tools for cryptocurrency trading and technical analysis across 100+ exchanges like Binance and MEXC via CCXT. It enables users to execute orders, track positions, and scan for market opportunities through Claude Desktop using natural language.2037 npmMIT
- AlicenseBqualityBmaintenanceOpen-source MCP server for market analysis: screeners, multi-timeframe technical analysis and backtests for crypto, stocks, forex and futures. 39 tools. Hosted version: TradingMCP.371,483 PyPI5,292MIT
- AlicenseNot gradedqualityDmaintenanceThe most complete AI-powered trading toolkit for Claude and MCP clients, offering backtesting, live sentiment, Yahoo Finance, and 30+ technical analysis tools in one MCP server.MIT