TTMT Docs

Appearance

MCP Quickstart — Connect in a Few Minutes ​

TTMT runs a remote Model Context Protocol (MCP) server. Once you connect it, you can ask Claude — or any MCP-compatible AI client — plain-English questions about your own trading data: your trades, positions, performance, settings, channels, and risk status. No SQL, no exports, no copy-paste. You ask; it reads your account and answers.

The connector URL is the only thing you need to copy:

https://app.telegramtometatrader.com/api/mcp/mcp

Availability

MCP access is enabled per account by the TTMT team and is rolling out gradually. It uses the same account gate as the Developer API — even after you sign in successfully, the connection only works once your account has API access turned on. If sign-in or the consent step fails, your account may still be getting enabled. Contact support and we'll sort it out.

Read-only, always

The MCP server can only read your data. It can never place, modify, or close a trade, change a setting, move funds, or touch another user's account. There is no write capability — asking Claude to "close my position" through the connector simply won't do anything, because the tools to act don't exist. It reads and answers; nothing more.

Connect in 3 steps ​

  1. Copy the connector URL above: https://app.telegramtometatrader.com/api/mcp/mcp.
  2. Add it in your AI client and sign in. Paste the URL as a custom connector, then sign in with your normal TTMT account — the same email and password you use for the dashboard. There's no separate MCP password or API key to manage.
  3. Approve the read-only consent screen. Your client shows a consent screen asking to grant read-only access to your TTMT data. Review it, click Allow, and you're connected.

Now ask your first question. Try:

"Give me my morning trading summary."

Claude will pull your recent closed P&L, open positions, any halted accounts, skipped signals, and your best and worst channel for the period — in one answer.

Pick your client ​

The steps above are the same everywhere; the exact menu path differs by client. Follow the guide for yours:

ClientGuide
Claude (claude.ai)Connect on claude.ai
Claude DesktopConnect in Claude Desktop
Claude CodeConnect in Claude Code
Any other MCP clientOther MCP clients

Any client that supports Streamable HTTP and OAuth 2.1 will work — point it at the connector URL and it walks you through sign-in and consent. (The legacy SSE transport is not supported.)

A few things worth knowing ​

  • You sign in with your TTMT account. Supabase Auth handles the sign-in; there's no extra credential to create for MCP.
  • Every request is re-checked. Access is verified on every request, so there are no long-lived sessions sitting around. Revoke the connector from your client's settings any time — TTMT never initiates the disconnect.
  • Fair-use rate limit. Requests are capped at 60 per minute per user, shared across all your MCP clients. If you hit the cap, requests may briefly look like a sign-in failure rather than an explicit "too many requests" message — a known client-side quirk. Wait a moment and try again.

What you can ask ​

Fourteen read-only tools cover trades, positions, performance, settings, profiles, channels, signals, and risk — plus an advisory settings healthcheck and a hypothetical order-plan preview. A few examples:

  • "Show me my losing XAUUSD trades this week."
  • "What's my total floating P&L right now?"
  • "How does my Aggressive profile compare to Balanced last month?"
  • "Why didn't my last EURUSD signal get traded?"
  • "If I got a XAUUSD BUY signal now, what would my order plan look like?"

See the full tool catalog for everything the connector can answer.