Model Context Protocol · Live

Connect any AI assistant
to your IQ Option

One token, four markets, any AI of your choice. Talk to Claude, ChatGPT or Cursor about your positions, markets and trades. No code, three steps.

Start in 3 steps → Ready-made configs
1
Token for everything
4
MCP servers
12+
AI assistants
~3 min
To set up
01 · What is MCP

One protocol. Any AI talks to your account.

MCP (Model Context Protocol) is an open standard from Anthropic through which AI assistants connect to external systems. We host servers for each instrument type — you create a token and paste it into your assistant.

⚡

Analyse markets in plain language

Ask AI about live quotes, historical candles, spreads, volumes — in your own words, across all 4 markets at once.

📊

See your portfolio in chat

Open positions, pending orders, trade history, total equity — all through plain conversation. No window switching.

🛡️

Token-level control

Each token is a separate integration with its own lifetime. See all active ones in Settings → AI integrations and revoke any of them with one click.

02 · Available servers

Four markets — four MCP endpoints.

Each instrument type lives on its own server. A single token from your IQ Option settings works on all four — connect all of them or just the ones you need.

▸ Digital Options
https://digital-options.mcp.iqoption.com
▸ Margin CFD
https://marginal-cfd.mcp.iqoption.com
▸ Margin Crypto
https://marginal-crypto.mcp.iqoption.com
▸ Margin Forex
https://marginal-forex.mcp.iqoption.com
i
1 token — 4 servers. Create one Bearer token in IQ Option (Settings → AI integrations) and reuse it in all four configs. Below we provide a ready-made config that connects all markets in a single block.
03 · Token permissions

Read by default. Trade — opt-in, per market.

Every token has its own scope. Read access to all 4 servers is enabled automatically and cannot be turned off — AI needs it just to "see" your data. The right to open and close trades is granted explicitly — separately for each market, when you create the token.

🔑

New AI integration token

Settings → AI integrations → Add
▸ Read access · always on
Always
▸ Trade access · opt-in
Optional
Optional
Optional
Optional
⏱ Expiry: 30–90 days
🏷 Label: Claude · Demo
📍 Scope: Account-specific

🟢 Read — cannot be turned off

Without read access AI is useless — it can't show your balance or prices. That's why the read scope is enabled automatically across all 4 servers. This is the safest level: AI only looks, never touches.

🟠 Trade — surgical, per use case

Want AI to help trade only options? Tick Trade · Digital Options and nothing else. Margin CFD/Crypto/Forex stay read-only — even if AI tries, the server returns 403 Forbidden.

🔵 Scope can be changed without recreating the token

Want to drop a trade permission from a token that's already in use? Open Settings → AI integrations, find the token, uncheck the market — the permission is dropped instantly. The token value itself does not change, so no need to update your assistant's config.

📋

Ready-made permission sets by scenario

Pick the one closest to your use case
📊 Read-only research
AI helps analyse markets, read your portfolio, calculate P&L — but never trades. The safest setup.
Read only
🎯 Options-only auto-trade
Read everywhere + Trade on Digital Options. CFD/Crypto/Forex remain off-limits.
+ Options
🪙 Crypto-only swing
Read everywhere + Trade on Margin Crypto. Options, CFD and forex remain untouchable for AI.
+ Crypto
🚀 Full access
Read + Trade on all 4 servers. Maximum capability — and maximum responsibility. Only when you fully trust this specific assistant.
All 4
04 · How to connect

Three steps. No code, no terminal.

Our MCP runs over streamable-HTTP — no Python environments, no virtual venv, no repos to clone. Just a URL + Bearer token you create in one click.

1

Create a token

In the mobile app or on the web:

  1. Open Settings → AI integrations →
  2. Tap + Add integration
  3. Give the token a name and an expiry
  4. Tick which markets are allowed for trading (read is always on). Details — section 03 above
  5. Copy the token immediately — once you close the screen it won't be shown again
Open AI integrations →
2

Pick your assistant

Native MCP support is available in:

  1. Claude Desktop / Claude Code
  2. Cursor / Windsurf / Zed
  3. OpenAI Codex / ChatGPT Desktop
  4. Cline / Continue / Goose / LibreChat
3

Paste the config

Copy the snippet for your assistant. Each one needs three things:

  1. The server URL
  2. Authorization: Bearer + your token
  3. Restart your assistant
05 · Ready-made configs

Pick your assistant — the config is ready.

Each snippet connects all 4 servers at once. Just replace YOUR_TOKEN with the token you created in step 1. If you only need one market, keep just that block and delete the rest.

Claude Desktop

Easy
Anthropic's desktop app for Mac and Windows. Native MCP support. Edit one JSON file, restart — done.
▸ Mac
~/Library/Application Support/Claude/claude_desktop_config.json
▸ Windows
%APPDATA%\Claude\claude_desktop_config.json
claude_desktop_config.json 
{
  "mcpServers": {
    "iq-digital-options": {
      "transport": "streamable-http",
      "url": "https://digital-options.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-cfd": {
      "transport": "streamable-http",
      "url": "https://marginal-cfd.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-crypto": {
      "transport": "streamable-http",
      "url": "https://marginal-crypto.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-forex": {
      "transport": "streamable-http",
      "url": "https://marginal-forex.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}
✓
Verify the connection. Restart Claude Desktop and ask: What IQ Option tools do I have available? — you'll see the tools list from all four servers.

Claude Code (CLI)

Easy
Anthropic's terminal-based AI. One shell command per server. No config file — everything via CLI.
Terminal · add 4 servers 
# Digital Options
claude mcp add --transport http iq-digital-options \
  https://digital-options.mcp.iqoption.com \
  --header "Authorization: Bearer YOUR_TOKEN"

# Margin CFD
claude mcp add --transport http iq-margin-cfd \
  https://marginal-cfd.mcp.iqoption.com \
  --header "Authorization: Bearer YOUR_TOKEN"

# Margin Crypto
claude mcp add --transport http iq-margin-crypto \
  https://marginal-crypto.mcp.iqoption.com \
  --header "Authorization: Bearer YOUR_TOKEN"

# Margin Forex
claude mcp add --transport http iq-margin-forex \
  https://marginal-forex.mcp.iqoption.com \
  --header "Authorization: Bearer YOUR_TOKEN"
✓
Verify. Run claude mcp list — you should see 4 lines with ✓ connected status.

Cursor

Easy
AI-first code editor. Settings → MCP → edit mcp.json directly or via the UI.
▸ Mac · Linux
~/.cursor/mcp.json
▸ Windows
%USERPROFILE%\.cursor\mcp.json
mcp.json 
{
  "mcpServers": {
    "iq-digital-options": {
      "url": "https://digital-options.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-cfd": {
      "url": "https://marginal-cfd.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-crypto": {
      "url": "https://marginal-crypto.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-forex": {
      "url": "https://marginal-forex.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}
✓
Settings → MCP will show 4 servers with ● Green status. No restart needed — Cursor hot-reloads.

Windsurf (Codeium)

Medium
AI editor by Codeium. Configure via UI or directly via the JSON file.
Settings → Windsurf Settings → MCP Servers → Edit configuration
mcp_config.json 
{
  "mcpServers": {
    "iq-digital-options": {
      "serverUrl": "https://digital-options.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-cfd": {
      "serverUrl": "https://marginal-cfd.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-crypto": {
      "serverUrl": "https://marginal-crypto.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-forex": {
      "serverUrl": "https://marginal-forex.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}
✓
Windsurf → Settings → MCP servers will show the status. If you see an error, hit Refresh.

OpenAI Codex CLI

Medium
OpenAI's Codex CLI. Config file in TOML format inside the Codex profile directory.
Codex profile · config.toml
config.toml 
[mcp_servers.iq-digital-options]
url = "https://digital-options.mcp.iqoption.com"
headers = { Authorization = "Bearer YOUR_TOKEN" }

[mcp_servers.iq-margin-cfd]
url = "https://marginal-cfd.mcp.iqoption.com"
headers = { Authorization = "Bearer YOUR_TOKEN" }

[mcp_servers.iq-margin-crypto]
url = "https://marginal-crypto.mcp.iqoption.com"
headers = { Authorization = "Bearer YOUR_TOKEN" }

[mcp_servers.iq-margin-forex]
url = "https://marginal-forex.mcp.iqoption.com"
headers = { Authorization = "Bearer YOUR_TOKEN" }
✓
In the chat: /mcp shows the list of servers. Run codex mcp status to verify.

ChatGPT Desktop

Medium
OpenAI's desktop app. MCP is added via Settings → Connectors → Custom MCP Server.
Settings → Connectors 
# Add 4 connectors, one at a time:

Name:           IQ Digital Options
Server URL:     https://digital-options.mcp.iqoption.com
Transport:      Streamable HTTP
Auth header:    Authorization: Bearer YOUR_TOKEN

Name:           IQ Margin CFD
Server URL:     https://marginal-cfd.mcp.iqoption.com
Auth header:    Authorization: Bearer YOUR_TOKEN

Name:           IQ Margin Crypto
Server URL:     https://marginal-crypto.mcp.iqoption.com
Auth header:    Authorization: Bearer YOUR_TOKEN

Name:           IQ Margin Forex
Server URL:     https://marginal-forex.mcp.iqoption.com
Auth header:    Authorization: Bearer YOUR_TOKEN
i
Enable connectors in the chat. Before starting a conversation, click the Connectors icon under the prompt and select the ones you need. Available on Plus / Pro / Team subscriptions.

Cline (VS Code Extension)

Easy
Popular AI agent for VS Code. MCP settings live in the Cline panel → MCP Servers → Edit Configuration.
Cline panel → MCP Servers → Edit Configuration
cline_mcp_settings.json 
{
  "mcpServers": {
    "iq-digital-options": {
      "url": "https://digital-options.mcp.iqoption.com",
      "transport": "streamable-http",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "disabled": false
    },
    "iq-margin-cfd": {
      "url": "https://marginal-cfd.mcp.iqoption.com",
      "transport": "streamable-http",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "disabled": false
    },
    "iq-margin-crypto": {
      "url": "https://marginal-crypto.mcp.iqoption.com",
      "transport": "streamable-http",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "disabled": false
    },
    "iq-margin-forex": {
      "url": "https://marginal-forex.mcp.iqoption.com",
      "transport": "streamable-http",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" },
      "disabled": false
    }
  }
}
✓
In Cline → MCP Servers you'll see 4 servers with ● connected status.

Continue.dev

Medium
Open-source AI coding assistant for VS Code and JetBrains. Config in YAML inside the Continue profile directory.
Continue profile · config.yaml
config.yaml · mcpServers section 
mcpServers:
  - name: iq-digital-options
    type: streamable-http
    url: https://digital-options.mcp.iqoption.com
    requestOptions:
      headers:
        Authorization: "Bearer YOUR_TOKEN"

  - name: iq-margin-cfd
    type: streamable-http
    url: https://marginal-cfd.mcp.iqoption.com
    requestOptions:
      headers:
        Authorization: "Bearer YOUR_TOKEN"

  - name: iq-margin-crypto
    type: streamable-http
    url: https://marginal-crypto.mcp.iqoption.com
    requestOptions:
      headers:
        Authorization: "Bearer YOUR_TOKEN"

  - name: iq-margin-forex
    type: streamable-http
    url: https://marginal-forex.mcp.iqoption.com
    requestOptions:
      headers:
        Authorization: "Bearer YOUR_TOKEN"
✓
Continue panel → MCP Servers → all 4 should appear.

Zed

Medium
Ultra-fast editor. MCP via context_servers in Zed settings (Cmd , / Ctrl ,).
Zed settings.json
settings.json 
{
  "context_servers": {
    "iq-digital-options": {
      "source": "custom",
      "transport": "http",
      "url": "https://digital-options.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-cfd": {
      "source": "custom",
      "transport": "http",
      "url": "https://marginal-cfd.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-crypto": {
      "source": "custom",
      "transport": "http",
      "url": "https://marginal-crypto.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    },
    "iq-margin-forex": {
      "source": "custom",
      "transport": "http",
      "url": "https://marginal-forex.mcp.iqoption.com",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}
✓
Open the Agent panel in Zed — the servers should appear under Available Tools.

Goose (Block)

Medium
Open-source AI agent by Block (formerly Square). Extensions configured in YAML.
Goose config · config.yaml
config.yaml · extensions section 
extensions:
  iq-digital-options:
    type: streamable_http
    uri: https://digital-options.mcp.iqoption.com
    headers:
      Authorization: "Bearer YOUR_TOKEN"
    enabled: true

  iq-margin-cfd:
    type: streamable_http
    uri: https://marginal-cfd.mcp.iqoption.com
    headers:
      Authorization: "Bearer YOUR_TOKEN"
    enabled: true

  iq-margin-crypto:
    type: streamable_http
    uri: https://marginal-crypto.mcp.iqoption.com
    headers:
      Authorization: "Bearer YOUR_TOKEN"
    enabled: true

  iq-margin-forex:
    type: streamable_http
    uri: https://marginal-forex.mcp.iqoption.com
    headers:
      Authorization: "Bearer YOUR_TOKEN"
    enabled: true
✓
goose session will show the loaded extensions on start.

Cherry Studio

Easy
Multi-model desktop AI client with native MCP. Fully via UI — no JSON required.
Settings → MCP Servers → Add 
# Add 4 servers; for each one:

Name:            iq-digital-options  (or another)
Type:            HTTP (Streamable)
URL:             https://digital-options.mcp.iqoption.com
Headers:
  Authorization → Bearer YOUR_TOKEN

# Repeat for marginal-cfd, marginal-crypto, marginal-forex.
# Enable the toggle next to each server.
✓
In the chat pick a model → there's a Tools icon on the right → pick the servers for your session.

LibreChat

Medium
Open-source multi-model chat server (self-hosted). MCP via the main librechat.yaml.
librechat.yaml
librechat.yaml · mcpServers section 
mcpServers:
  iq-digital-options:
    type: streamable-http
    url: https://digital-options.mcp.iqoption.com
    headers:
      Authorization: "Bearer YOUR_TOKEN"

  iq-margin-cfd:
    type: streamable-http
    url: https://marginal-cfd.mcp.iqoption.com
    headers:
      Authorization: "Bearer YOUR_TOKEN"

  iq-margin-crypto:
    type: streamable-http
    url: https://marginal-crypto.mcp.iqoption.com
    headers:
      Authorization: "Bearer YOUR_TOKEN"

  iq-margin-forex:
    type: streamable-http
    url: https://marginal-forex.mcp.iqoption.com
    headers:
      Authorization: "Bearer YOUR_TOKEN"
✓
Restart the container: docker compose restart api. MCP tools will appear under Plugins.

Custom / Enterprise

Medium
Your own agent, in-house platform, or any system that speaks MCP per spec. Universal parameters:
Universal MCP parameters 
Transport:      streamable-http (HTTP/SSE per spec)
Method:         POST  (for invocations)
URL:            https://<market>.mcp.iqoption.com
Header:         Authorization: Bearer YOUR_TOKEN
Content-Type:   application/json

# Available <market> values:
#  · digital-options · marginal-cfd
#  · marginal-crypto · marginal-forex
Sanity check · curl 
curl -X POST https://digital-options.mcp.iqoption.com \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
✓
If curl returned JSON with a tools list — your token and URL are working. From there, implement the MCP client per spec.modelcontextprotocol.io.
06 · Safety

Your token, your responsibility. Guardrails are built in.

MCP gives AI the keys to your trading account. So we — and you — watch the limits together.

🔐

Token lives in headers, not in chat

The Bearer token is attached to the HTTP header on the assistant ↔ server connection. AI does not see it in the message body and cannot accidentally send it out.

⚠

Don't share. Don't commit.

The token = access to your trading account. Never publish in git, screenshots, chats or gists. If you suspect a leak — open Settings → AI integrations and hit Revoke next to that token. All requests using it stop working instantly.

i

Expiry and rotation

You set the expiry at creation. After that date the token stops working automatically. We recommend keeping separate tokens per integration — that way you can revoke only what you need.

!

Start small

AI is powerful but not infallible. It can pick the wrong instrument, size, or direction. Before trusting the model with size — walk through scenarios manually and double-check its suggestions. The responsibility for every trade is yours.

07 · Example prompts

What to ask AI once connected.

Plain language — no commands or slashes. Ask in English, Spanish, Portuguese, or your own language — the model figures out which server to call.

Account

  • Show my balance
  • Which account am I on right now
  • List my IQ Option accounts
  • How much free margin do I have

Markets

  • Which assets are available on Margin Crypto
  • Show me the EUR/USD quote
  • Compare BTC movement over the last hour
  • What are the current spreads on the top 5 forex pairs

Portfolio

  • Show my open positions
  • List my pending orders
  • What's my total account exposure
  • How many trades did I make today

Trading

  • Open a long BTC at 0.01 with a 5% stop loss
  • Buy a 5-minute EUR/USD call option
  • Close all my Tesla positions
  • Place a limit buy on SPY around 580
08 · Frequently asked questions

FAQ

Do I need to install anything on my computer?

No. Our MCP servers are hosted by us — no repos to clone, no Python or venv to install. Just the URL + Bearer token in your AI assistant's config.

Does one token really work on all 4 servers?

Yes. Create a single Bearer token in Settings → AI integrations and use it in the Authorization header for all four endpoints: digital-options, marginal-cfd, marginal-crypto, marginal-forex.

What if I only want to connect one market, e.g. Forex?

Delete the other blocks from the config — keep only iq-margin-forex. AI will see only the tools from that server and won't be able to touch, e.g., options by accident.

What can AI actually do through MCP?

Each of our servers exposes its own tools list — you can see the full set right after connecting by asking the assistant: "What IQ Option tools do you have?". In total this is reading market data, portfolio and trades, plus methods to open/close positions. Which methods are available to a specific token is determined by its scope (read + optionally trade per market).

How do I make sure AI can't trade?

When creating the token in Settings → AI integrations just don't tick any of the four "Trade · …" checkboxes. Read stays on (it can't be turned off — AI needs it), and any attempt to call a trading tool will return 403 Forbidden. This is the safest setup for research use cases.

Can I allow trading on only one instrument?

Yes. For example, tick only Trade · Margin Crypto — AI will be able to open/close crypto positions, but options, CFD and forex stay read-only. Useful when you're testing the AI setup on a market you're comfortable with.

What if I want to drop a trade permission from an existing token?

Open Settings → AI integrations, find the token and uncheck the relevant box (e.g. Trade · Margin CFD). The permission is removed instantly — the server will start returning 403 Forbidden on trading calls for that market. The token value itself doesn't change, so no need to touch your assistant's config.

What if my token leaked?

Go to Settings → AI integrations, find the compromised token and hit Revoke. All requests with it stop working instantly. Create a new one and update the assistant's config.

What are the limits on tokens and servers?

One account can have multiple active tokens at once (visible in the Active tokens list). One token works across all 4 servers. If you want separate keys per integration for easier revocation — create several and give them meaningful names.

My assistant doesn't see the tools after setup. What now?

Checklist: (1) restart the assistant completely, (2) make sure the token is copied without extra whitespace at the start/end, (3) check that the URL has no trailing slash and matches your subscription, (4) make sure the Authorization header starts exactly with Bearer (note the space), (5) check the assistant's logs — usually it's a JSON syntax error in the config.

Which assistant is the easiest to set up from scratch?

If you're not a developer — Claude Desktop or Cherry Studio: both have a UI that handles the config for you. If you live in code — Cursor or Claude Code will feel more natural.

Is using MCP free?

At the moment — yes, free for all IQ Option clients with an active account. You only pay for your AI assistant's subscription (Claude Pro / ChatGPT Plus, etc.).