---
url: /mcp/quickstart.md
description: >-
  Connect Claude, ChatGPT, or any MCP-compatible AI client to your own TTMT
  trading data in three steps and ask your first question.
---

# MCP Quickstart — Connect in a Few Minutes

TTMT runs a remote Model Context Protocol (MCP) server. Once you connect it, you can ask Claude, ChatGPT, 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
```

::: info Availability
MCP access depends on account enablement and the subscription-access rollout, separately from Developer API access. See [Account access](/mcp/security#account-access). If sign-in or consent fails, contact support to check your access.
:::

::: warning 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 your assistant 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."**

Your assistant 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:

| Client | Guide |
|:---|:---|
| **Claude (claude.ai)** | [Connect on claude.ai](/mcp/clients/claude-ai) |
| **Claude Desktop** | [Connect in Claude Desktop](/mcp/clients/claude-desktop) |
| **Claude Code** | [Connect in Claude Code](/mcp/clients/claude-code) |
| **ChatGPT** | [Connect in ChatGPT](/mcp/clients/chatgpt) |
| **Any other MCP client** | [Other MCP clients](/mcp/clients/other-clients) |

ChatGPT takes one extra step the Claude apps don't: custom MCP connectors sit behind its **developer mode**, which you switch on once in ChatGPT's settings. The [ChatGPT guide](/mcp/clients/chatgpt) walks it.

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.** Tool calls are capped at 60 per minute per user, shared across all your MCP clients. If you hit the cap, your assistant tells you the per-minute limit was reached and how long to wait. You stay signed in. Wait up to a minute and ask again.

## What you can ask

Twenty read-only tools cover trades, positions, performance, settings, presets, 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 preset 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](/mcp/tools) for everything the connector can answer.

## Related pages

* [MCP overview](/mcp/)
* [Full tool catalog](/mcp/tools)
* [Connect on claude.ai](/mcp/clients/claude-ai)
* [Connect in Claude Desktop](/mcp/clients/claude-desktop)
* [Connect in Claude Code](/mcp/clients/claude-code)
* [Connect in ChatGPT](/mcp/clients/chatgpt)
* [Other MCP clients](/mcp/clients/other-clients)
