# MTContext MCP Quickstart

Connect Claude, Cursor, or any [MCP](https://modelcontextprotocol.io)-compatible
client to a MetaTrader 4 or 5 terminal — no Python, no local server to run.

MTContext is a **cloud-hosted, remote MCP server**. There's nothing to clone,
build, or `pip install` from this repo — this repo exists to document the
connection and point at the real thing. (This is intentional: the server
implementation itself is closed-source, cloud infrastructure, not something
you run yourself.)

## How it works

1. [Sign up](https://mtcontext.com) (free tier: read-only market data, no card required).
2. Drag one Expert Advisor file (`.ex5` for MT5, `.ex4` for MT4 — MT4 support
   coming soon) onto a chart in your MetaTrader terminal.
3. Copy your ready-made MCP config snippet from the dashboard and paste it
   into your client's config.
4. Ask your AI client, in plain English, for live prices, account state,
   indicators, or — when you explicitly allow it — trades. Every
   trade-affecting call defaults to `dry_run: true` until you confirm.

## Connection

MTContext exposes a single remote **Streamable HTTP** MCP endpoint per account:

```json
{
  "mcpServers": {
    "mtcontext": {
      "type": "http",
      "url": "https://mcp.mtcontext.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer YOUR_LICENSE_KEY"
      }
    }
  }
}
```

Get your real `YOUR_LICENSE_KEY` from your [dashboard](https://mtcontext.com/dashboard)
after connecting a terminal — see [`examples/claude_desktop_config.example.json`](examples/claude_desktop_config.example.json).

## What you can ask it

- "What's the current EURUSD bid and ask?"
- "What's my account balance and open positions?"
- "Run RSI and MACD on GBPUSD, H1."
- "Size a position on XAUUSD risking 1% of my equity with a 30-pip stop."
- "Place a dry-run buy on EURUSD, 0.1 lots, and show me what would happen."

Full tool reference: [docs.mtcontext.com](https://docs.mtcontext.com).
Setup guides and troubleshooting: [help.mtcontext.com](https://help.mtcontext.com/hc/knowledge-base/en).

## Why not a self-hosted MCP server?

Several open-source MetaTrader MCP servers exist and require installing
Python and running a local process yourself, usually MT5-only, with no
safety layer beyond what you build. MTContext trades that developer-only
setup for a one-file install, MT4 *and* MT5, and a dry-run-by-default safety
model — aimed at traders, not just developers who happen to trade.

## Links

- [mtcontext.com](https://mtcontext.com) — sign up
- [docs.mtcontext.com](https://docs.mtcontext.com) — full documentation
- [help.mtcontext.com](https://help.mtcontext.com/hc/knowledge-base/en) — Help Center
- [Model Context Protocol](https://modelcontextprotocol.io)

## License

The contents of this repository (documentation and examples) are MIT
licensed — see [LICENSE](LICENSE). This does not cover the MTContext service
itself, which is proprietary.