MCP AI assistant overview

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants call typed tools running on a remote server. BotTradesForYou exposes a single MCP endpoint at https://bottradesforyou.com/api/mcp that gives an authenticated assistant read-only status tools and a small set of mutating tools (start/stop/restart bots, force enter/exit trades).

What you can do

• Ask "which of my bots is running?" and the assistant calls list_bots.
• Ask "why did bot X stop?" and the assistant reads recent log lines with get_bot_logs.
• Ask "close the losing trade on bot X" and the assistant calls force_exit_trade.
• Ask for a portfolio summary, daily profit, or the latest trades — all read-only.

Security model

• Scoped API keys. Keys are minted from the dashboard, prefixed btfy_mcp_, and can be revoked at any time. The plaintext value is shown once and never again.
• Plan-gated. MCP access requires a paid plan (mcp_access entitlement). Free plans get a FORBIDDEN error at every mcp endpoint.
• Every guardrail inherited. Tools call the same tRPC procedures the dashboard does, so per-user rate limits, trading-policy flags, ownership checks, and audit logging all apply.
• No new trading capabilities. MCP cannot mint keys over the network, cannot edit exchange credentials, cannot upload strategies, and cannot see anyone else's data.

Not included in this release

• Strategy authoring / uploading (dashboard-only, by design).
• Exchange credential management (dashboard-only).
• OAuth / dynamic client registration (bearer-only for now).
• Streaming SSE transport (stateless JSON is the only supported mode).

Read the quickstart to configure your first client.