API & MCP Support

ForexGPT Model Context Protocol (MCP) Server – Complete Integration Guide

Status: ✅ Live in Production (BETA)
Last Updated: January, 2026
Version: 2.0.1-enhanced
Audience: Premium ForexGPT subscribers

📋 Table of Contents

1. Overview
2. What is MCP?
3. Key Features
4. Live Demonstration
5. Prerequisites
6. Setup Instructions
   • Method 1: Interactive OAuth (Recommended)
   • Method 2: Personal API Token
7. Available Tools & Capabilities
8. Authentication & Security
9. Usage Examples
10. Troubleshooting
11. Technical Specifications
12. Rate Limits & Quotas
13. Best Practices
14. Support & Resources
15. Legal Disclaimers

Overview

The ForexGPT MCP Server enables premium users to access our comprehensive analysis platform directly through AI assistants like Claude and ChatGPT. By implementing the Model Context Protocol, we’ve created a seamless bridge between conversational AI and professional-grade market analysis.

What Makes This Unique?

• Native Integration: No copying and pasting – the AI calls ForexGPT tools directly
• Real-time Analysis: Live market data and technical calculations on demand
• Multi-Asset Support: 120+ instruments including forex, crypto, commodities, and indices
• Conversational Interface: Ask natural language questions, get concise analysis
• Watchlist Management: Save and monitor your portfolio across sessions

Quick Start

MCP Server URL: https://mcp.forex-gpt.ai/mcp
Authentication: OAuth 2.0 or Personal API Token (generate token in dashboard after login via https://live4.forex-gpt.ai/dashboard)
Supported Clients: Claude (desktop and web) and ChatGPT (with custom connectors enabled adding our MCP server url)

What is MCP?

The Model Context Protocol (MCP) is an open standard developed by Anthropic that allows AI assistants to securely connect to external data sources and tools. Think of it as a standardized API specifically designed for AI assistants.

Why MCP Matters

Before MCP:

• Users copy data between systems manually
• AI has no real-time market access
• Analysis becomes stale quickly
• Context is limited to chat history

With MCP:

• AI directly calls analysis tools
• Real-time market data on demand
• Fresh calculations every query
• Persistent watchlists and preferences

How It Works

You → Claude/ChatGPT → MCP Protocol → ForexGPT Server → Market Data APIs
                                    ↓
                            Technical Analysis Engine
                                    ↓
                      Results → Claude/ChatGPT → You

The AI assistant acts as an intelligent interface, deciding when to call ForexGPT tools based on your questions and presenting results in a clear, actionable format.

Key Features

🎯 Market Analysis

• Single Asset Analysis: Deep dive into any instrument with full technical indicators
• Multi-Timeframe Analysis: Compare daily, 4-hour, hourly charts simultaneously (up to 15 timeframes per asset, or 15 assets per timeframe)
• Watchlist Analysis: Batch analyze 15 watchlist items in your portfolio in one request
• Market Scanning: Discover opportunities across 120+ instruments

📊 Technical Capabilities

• 20+ technical indicators (RSI, MACD, Bollinger Bands, Fibonacci, etc.)
• Trend detection and regime classification
• Support/resistance level identification
• Multi-timeframe confluence scoring
• Sentiment analysis (0-100 scale)
• Signal generation with entry/exit recommendations

📈 Data Access

• OHLC candlestick data (up to 400 candles)
• Real-time bid/ask spreads
• Economic calendar events
• Historical analysis database
• Research blog content

🔧 Portfolio Management

• Persistent watchlists across sessions
• Add/remove assets on the fly

🌐 Market Coverage

• Forex: 50+ major, minor, and exotic pairs
• Cryptocurrencies: Bitcoin, Ethereum, Bitcoin Cash, Litecoin,
• Commodities: Gold, Silver, Oil, Natural Gas, Wheat, Corn, and More
• Indices: SPX500, NAS100, US30, UK100, and more

Live Demonstration

Watch how the integration works in practice with Claude analyzing GBP/USD and generating an interactive trading dashboard:

[Video shows Claude using ForexGPT MCP tools and create a comprehensive analysis dashboard]

Live demonstration of ForexGPT MCP server tools using ChatGPT Connector in developer mode:

Prerequisites

Required

✅ Active ForexGPT Premium Subscription – Free tier not supported
✅ Valid ForexGPT Account – Must have login credentials
✅ Supported AI Client – Claude Desktop or ChatGPT with custom connectors enabled
✅ Internet Connection – For real-time data access

Recommended

✅ Basic Trading Knowledge – To interpret analysis correctly
✅ Risk Management Skills – Essential for applying insights
✅ Demo Account – For practicing strategies before live trading

Not Required

❌ Coding experience
❌ API development knowledge
❌ DevOps expertise

The setup is designed for traders, not developers. If you can log in to ForexGPT, you can use the MCP server.

Setup Instructions

Method 1: Interactive OAuth (Recommended)

Best for: Most users who want a simple, secure setup.

For Claude Desktop Users

Step 1: Open Claude Desktop Settings

• Launch Claude Desktop application
• Click the settings icon (gear) in the bottom-left
• Navigate to “Developer” or “Connectors” section

Step 2: Add Custom MCP Server

• Click “Add Custom Connector” or “Edit Config”
• Enter the following configuration:

{
  "mcpServers": {
    "forex-gpt": {
      "url": "https://mcp.forex-gpt.ai/mcp",
      "description": "ForexGPT forex and crypto analysis tools"
    }
  }
}

Step 3: Authenticate

• Leave any Oauth fields blank (authentication will happen later automatically)
• Claude will detect the new MCP server
• Click “Connect” or “Authenticate”
• You’ll be redirected to ForexGPT login page
• Enter your existing ForexGPT username and password
• Authorize Claude to access your account
• You’ll be redirected back to Claude Desktop, then you can invoke the ForexGPT connector in new chats (you must enable all tools from ForexGPT and allow connections)

Step 4: Verify Connection

• Start a new conversation in Claude
• Ask: “What tools do you have access to from ForexGPT?”
• Claude should list available analysis tools
• Try: “Analyze EUR/USD on the daily chart”

Troubleshooting Claude Desktop:

• If tools don’t appear, restart Claude Desktop
• Check that you’re logged in to ForexGPT dashboard in your browser
• Ensure your premium subscription is active
• Review Claude’s error logs (Help → Show Logs)

For ChatGPT Users

Step 1: Enable Developer Mode

• Go to ChatGPT settings
• Enable “Developer Mode” (note: this disables memory)
• Navigate to “Custom Connectors”

Step 2: Add ForexGPT Connector

• Click “Add Custom Connector”
• Enter connector details:

Name: Forex-GPT.ai MCP connector
URL: https://mcp.forex-gpt.ai/mcp
Description: Forex GPT MCP connector
OAuth: (leave these blank and unchecked)

Step 3: Configure Authentication

• ChatGPT will guide you through authorization
• Use your ForexGPT credentials when prompted

Step 4: Test Connection

• Start a new conversation
• Ask: “Use ForexGPT to analyze GBP/USD”
• ChatGPT should invoke the analysis tool
• Verify you receive technical analysis data

Troubleshooting ChatGPT:

• Custom connectors are only available in Plus/Enterprise
• Developer mode must be enabled
• Clear browser cache if authorization fails
• Try disconnecting and reconnecting the connector

Method 2: Personal API Token (Advanced)

Best for: Programmatic access, automation, or users who prefer token-based auth.

What is a Personal API Token?

A Personal API Token is a long-lived credential (90 days) that allows authentication without interactive login. It’s tied to your ForexGPT account and provides full access to MCP tools.

Use cases:

• Automated trading systems
• Custom integrations
• Scheduled analysis jobs
• API clients that don’t support OAuth

Security considerations:

• Treat tokens like passwords – never share them
• Tokens provide full account access
• Rotate tokens every 90 days (or sooner)
• Revoke immediately if compromised

Step-by-Step Token Setup

Step 1: Generate Token

1. Log in to ForexGPT Dashboard
2. Navigate to “API Access” section (in sidebar)
3. Click “Generate New Token”
4. Confirm action (this invalidates any existing token)
5. Copy the token immediately – you won’t see it again!

Step 2: Configure Your MCP Client

For Claude Desktop, edit your config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "forex-gpt": {
      "url": "https://mcp.forex-gpt.ai/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Replace YOUR_TOKEN_HERE with your actual token from Step 1.

Step 3: Secure Your Token

✅ Do:

• Store token in a secure password manager
• Use environment variables for programmatic access
• Set calendar reminder to rotate before 90-day expiry
• Revoke token immediately if you suspect compromise

❌ Don’t:

• Commit tokens to GitHub or public repositories
• Share tokens in chat or email
• Store in plaintext files without encryption
• Reuse the same token across multiple systems

Step 4: Verify Token Works

Restart Claude Desktop and test:

You: "Analyze Bitcoin on the 4-hour chart using ForexGPT"
Claude: [calls analyze_asset tool and returns BTC analysis]

If you see analysis results, your token is working correctly.

Token Management

View Token Status:

• Dashboard → API Access → Token Status
• Shows: Issued date, expiry date, last used

Revoke Token:

• Dashboard → API Access → Revoke Token
• Takes effect immediately
• All active connections using that token will fail

Rotate Token:

• Generate new token before old one expires
• Update all systems with new token
• Verify new token works
• Revoke old token

ForexGPT MCP Server – Complete Documentation

Version: 2.0.1 | Protocol: MCP 2026-01-22 | Last Updated: January 2026
Server URL: https://mcp.forex-gpt.ai/mcp
OAuth Issuer: https://oauth.forex-gpt.ai

ForexGPT MCP Server provides AI-powered forex market analysis, real-time data, and OANDA trading capabilities through the Model Context Protocol (MCP).

Table of Contents

1. Quick Start
2. All Tools Reference (45 Tools)
3. Prompts (10 Conversation Starters)
4. Resources (28 Widgets)
5. Authentication & Security
6. Technical Specifications
7. Error Handling
8. Support

Quick Start

Claude Desktop Connection

1. Open Claude Desktop → Settings → Developer → MCP Servers
2. Add server URL: https://mcp.forex-gpt.ai/mcp
3. Click Connect and authenticate with your ForexGPT account
4. Start with: “Find me the best trading opportunities right now”

ChatGPT Connection

1. Visit ChatGPT → Explore GPTs → Search “ForexGPT”
2. Click Connect MCP Server
3. Authorize with your ForexGPT credentials
4. Try: “Scan the market for strong setups”

All Tools Reference

Discovery & Scanning

scan_market

Title: Scan Market
Description: Scans entire market universe (Forex, Crypto, Metals, Indices) to find strongest trading opportunities ranked by sentiment strength.

Example: “Find me the best trading opportunities right now”

scan_market(timeframes=["D", "H4"], min_score=75, limit=10)

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_live_heatmap

Title: Live Heatmap
Description: Generates real-time sentiment heatmap snapshot. Uses provided assets, user’s watchlist, or default popular assets.

Example: “Show me a sentiment heatmap for the major pairs”

get_live_heatmap(timeframe="H4", assets=["EUR_USD", "GBP_USD", "USD_JPY"])

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

search

Title: Search
Description: Search forex analysis results by asset name, timeframe, or keywords.

Example: “Search for any analysis on gold”

search(query="XAU_USD daily")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false

list_assets

Title: List Assets
Description: Returns supported asset symbols from OANDA universe. Can filter by substring or test specific asset.

Example: “What JPY pairs can I trade?”

list_assets(filter="JPY")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false

get_blog_articles

Title: Get Blog Articles
Description: Get recent articles from the Forex-GPT blog feed.

Example: “Show me the latest ForexGPT blog posts”

get_blog_articles(max_results=5)

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

Deep Analysis

analyze_asset

Title: Analyze Asset
Description: Run comprehensive one-shot technical analysis for a single asset/timeframe combination. Requires subscription tokens.

Example: “Analyze EUR/USD on the 4-hour chart”

analyze_asset(asset="EUR_USD", timeframe="H4")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

analyze_timeframes

Title: Analyze Timeframes
Description: Analyze a single asset across multiple timeframes simultaneously for confluence. Requires subscription tokens.

Example: “Check gold on the weekly, daily, and 4-hour charts”

analyze_timeframes(asset="XAU_USD", timeframes=["W", "D", "H4"])

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

analyze_watchlist

Title: Analyze Watchlist
Description: Analyze all assets in user’s saved watchlist in parallel. Requires subscription tokens.

Example: “Run analysis on everything in my watchlist”

analyze_watchlist(timeframes=["D", "H4"])

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

fetch

Title: Fetch Analysis
Description: Retrieve complete pre-computed forex analysis by ID.

Example: “Get the cached daily analysis for Bitcoin”

fetch(id="BTC_USD_D")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

chart_chat_proxy

Title: Chart Chat Proxy
Description: Proxy to Flask chart-chat endpoint for AI-powered chart analysis.

Example: “What pattern do you see forming on this chart?”

chart_chat_proxy(message="What pattern do you see?", instrument="EUR_USD")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: false, openWorldHint: true

Market Data

get_chart_data

Title: Get Chart Data
Description: Retrieve OHLC candlestick data for charting purposes.

Example: “Get me 200 hourly candles for Bitcoin”

get_chart_data(asset="BTC_USD", timeframe="H1", count=200)

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_spreads

Title: Get Spreads
Description: Check current liquidity and trading cost (spread) for an asset.

Example: “What’s the spread on EUR/USD right now?”

get_spreads(asset="EUR_USD")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

economic_events

Title: Economic Events
Description: Fetch upcoming economic events via TradingView proxy.

Example: “What economic news is coming out this week?”

economic_events(fromDays=0, toDays=7)

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_price_stream_url

Title: Get Price Stream URL
Description: Get short-lived URL for real-time price streaming (SSE). Requires OANDA credentials.

Example: “Give me a live price feed for EUR/USD and GBP/USD”

get_price_stream_url(instruments=["EUR_USD", "GBP_USD"])

Returns: SSE stream URL (expires ~10 minutes)
Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_sentiment_stream_url

Title: Get Sentiment Stream URL
Description: Get short-lived URL for real-time sentiment streaming (SSE).

Example: “Stream live sentiment data for my watchlist”

get_sentiment_stream_url(instruments=["EUR_USD", "GBP_USD"])

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_server_time

Title: Get Server Time
Description: Return the server’s current UTC timestamp.

Parameters: None

Example: “What time is it on the server?”

get_server_time()

Returns: ISO 8601 timestamp
Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false

Watchlist Management

get_watchlist

Title: Get Watchlist
Description: View current assets in your saved watchlist.

Parameters: None

Example: “Show me what’s in my watchlist”

get_watchlist()

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false

add_to_watchlist

Title: Add to Watchlist
Description: Add a new asset to your persistent watchlist.

Example: “Add EUR/USD to my watchlist”

add_to_watchlist(asset="EUR_USD")

Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false

remove_from_watchlist

Title: Remove from Watchlist
Description: Remove an asset from your persistent watchlist.

Example: “Remove gold from my watchlist”

remove_from_watchlist(asset="XAU_USD")

Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: false

Trading Account

save_oanda_credentials

Title: Save OANDA Credentials
Description: Securely save your OANDA API Key and Account ID. Required before any trading.

Example: “Connect my OANDA demo account”

save_oanda_credentials(api_key="xxx-xxx-xxx", account_id="101-001-xxx")

⚠️ Credentials are encrypted and never exposed in responses.
Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false

delete_oanda_credentials

Title: Delete OANDA Credentials
Description: Remove your stored OANDA API Key and Account ID.

Parameters: None

Example: “Disconnect my OANDA account”

delete_oanda_credentials()

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: false

get_trading_account

Title: Get Trading Account
Description: Get trading account summary including balance, margin, and P&L. Requires OANDA credentials.

Parameters: None

Example: “What’s my account balance and margin?”

get_trading_account()

Returns: Balance, NAV, Margin Used/Available, Unrealized P&L
Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_account_history

Title: Get Account History
Description: Get account transaction history (closed trades, order fills, etc.). Requires OANDA credentials.

Example: “Show me my trading history from last month”

get_account_history(from_time="2025-12-01T00:00:00Z", type_filter="TRADE_CLOSE")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

Trading Orders

trade_market_order

Title: Trade Market Order
Description: Place an immediate market order. Positive units = BUY, Negative units = SELL. Supports trailing stop and guaranteed stop loss. Requires OANDA credentials.

Example: “Buy 10,000 EUR/USD with a 50 pip trailing stop”

trade_market_order(instrument="EUR_USD", units=10000, trailing_stop_distance=0.0050)

⚠️ DESTRUCTIVE: Modifies account state
Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true

trade_limit_order

Title: Trade Limit Order
Description: Place a pending limit order at a specific price. Requires OANDA credentials.

Example: “Set a limit order to buy EUR/USD at 1.0750”

trade_limit_order(instrument="EUR_USD", units=10000, price=1.0750)

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true

trade_stop_order

Title: Trade Stop Order
Description: Place a pending stop order (Buy Stop or Sell Stop). Triggers when price reaches level. Requires OANDA credentials.

Example: “Buy EUR/USD if it breaks above 1.1000”

trade_stop_order(instrument="EUR_USD", units=10000, price=1.1000)

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true

trade_modify_trade

Title: Modify Trade
Description: Modify Stop Loss and Take Profit of an existing open trade. Requires OANDA credentials.

Example: “Move my stop loss to breakeven on trade 12345”

trade_modify_trade(trade_id="12345", stop_loss=1.0900)

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true

cancel_pending_order

Title: Cancel Pending Order
Description: Cancel a specific pending order (Limit or Stop) that hasn’t triggered yet. Requires OANDA credentials.

Example: “Cancel my pending order for EUR/USD”

cancel_pending_order(order_id="12345")

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true

replace_pending_order

Title: Replace Pending Order
Description: Modify a pending order by replacing it with a new one. Requires OANDA credentials.

Example: “Change the price of my pending order 12345 to 1.0800”

replace_pending_order(order_id="12345", instrument="EUR_USD", units=10000, price=1.0800)

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true

get_pending_orders

Title: Get Pending Orders
Description: List all pending orders waiting to be filled. Requires OANDA credentials.

Parameters: None

Example: “Show me all my pending orders”

get_pending_orders()

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_order_history

Title: Get Order History
Description: Get a list of historical orders. Requires OANDA credentials.

Example: “Show me my order history for today”

get_order_history(state="FILLED", count=20)

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

Trading Positions

get_open_trades

Title: Get Open Trades
Description: List all currently open trade tickets. Requires OANDA credentials.

Parameters: None

Example: “What trades do I have open right now?”

get_open_trades()

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_open_positions

Title: Get Open Positions
Description: List net exposure per instrument (Long vs Short units). Requires OANDA credentials.

Parameters: None

Example: “What’s my total exposure on each pair?”

get_open_positions()

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_trade_details

Title: Get Trade Details
Description: Get full details of a specific trade (open or closed). Requires OANDA credentials.

Example: “Show me the details on trade 12345”

get_trade_details(trade_id="12345")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

close_trade

Title: Close Trade
Description: Close a specific trade (fully or partially). Requires OANDA credentials.

Example: “Close half of my position on trade 12345”

close_trade(trade_id="12345", units="5000")

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true

close_position

Title: Close Position
Description: Flatten entire exposure for a specific instrument. Requires OANDA credentials.

Example: “Close all my EUR/USD positions”

close_position(instrument="EUR_USD")

Annotations: readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true

Instrument Data

get_instrument_specs

Title: Get Instrument Specs
Description: Get instrument specifications (pip value, margin, trading hours).

Example: “What’s the pip value for EUR/USD?”

get_instrument_specs(instrument="EUR_USD")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_market_hours

Title: Get Market Hours
Description: Get current market trading hours by region.

Parameters: None

Example: “What markets are open right now?”

get_market_hours()

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

is_market_open

Title: Is Market Open
Description: Check if a specific instrument is currently tradeable.

Example: “Can I trade EUR/USD right now?”

is_market_open(instrument="EUR_USD")

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

refresh_instrument_data

Title: Refresh Instrument Data
Description: Refresh cached instrument information from OANDA.

Parameters: None

Example: “Refresh the instrument data cache”

refresh_instrument_data()

Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: true, openWorldHint: true

get_instrument_cache_status

Title: Get Instrument Cache Status
Description: View the status of the instrument data cache.

Parameters: None

Example: “Is the instrument cache up to date?”

get_instrument_cache_status()

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false

System & Support

health

Title: Health Check
Description: Comprehensive health check with optional upstream dependency verification.

Example: “Check if all services are running properly”

health(checkOANDA=true)

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

help_tutorial

Title: Help Tutorial
Description: Master tutorial for MCP tools with usage tips and suggested flows.

Parameters: None

Example: “How do I use ForexGPT?”

help_tutorial()

Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false

get_token_balances

Title: Get Token Balances
Description: Return current user’s token balances from account.

Parameters: None

Example: “How many tokens do I have left?”

get_token_balances()

Returns: Token quota, usage, purchased tokens, last reset
Annotations: readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true

Prompts

MCP Prompts are conversation starters that guide the AI on how to help you:

Resources

The MCP server provides 28 UI widget resources for rich visual displays:

Core Analysis Widgets

Trading Widgets

Watchlist & Analysis

Account & Profile

Information

Authentication & Security

OAuth 2.0 Flow

The MCP server uses OAuth 2.0 with Auth0 for secure authentication:

• Authorization Endpoint: https://oauth.forex-gpt.ai/authorize
• Token Endpoint: https://oauth.forex-gpt.ai/oauth/token
• Issuer: https://oauth.forex-gpt.ai

OANDA Trading Credentials

Trading features require linking your OANDA account:

1. Create free demo account at oanda.com
2. Generate API key from OANDA Portal → Manage API Access
3. Use save_oanda_credentials() to securely store

⚠️ Security Notes:

• Credentials are encrypted at rest
• API keys are never exposed in tool responses
• OAuth tokens cached with expiry validation
• All connections use TLS 1.2+

Technical Specifications

Server Info

Rate Limits

Tool Annotations Reference

Error Handling

HTTP Status Codes

Common Error Messages

“Insufficient tokens”

• Your analysis quota is depleted
• Check balance: get_token_balances()
• Purchase more at forex-gpt.ai

“OANDA credentials not found”

• Run save_oanda_credentials() first
• Verify account ID format: 101-001-XXXXXXX-XXX

“Market is closed”

• Check hours: get_market_hours()
• Wait for market open

“Invalid instrument”

• Verify with list_assets(filter=”…”)
• Use OANDA format: EUR_USD not EURUSD

Support

Documentation Links

• Main Docs: forex-gpt.ai/mcp-tutorial
• API Reference: forex-gpt.ai/api-mcp-support
• Getting Started: forex-gpt.ai/forexgpt-mcp-server-claude-and-chatgpt-connectors-or-via-api-key

Contact Channels

FAQ

Q: How do I get started with demo trading?
A: Create a free OANDA demo account, get your API key, then use save_oanda_credentials() to connect.

Q: Which tools consume tokens?
A: Analysis tools (scan_market, analyze_asset, analyze_timeframes, analyze_watchlist, chart_chat_proxy, get_live_heatmap) consume tokens. Data tools are free.

Q: Can I use this with a live trading account?
A: No, and we recommend starting with a demo to learn the software first. The API/Account credentials only work for practice accounts from OANDA.

Supported Asset Classes

Forex (50+ pairs):

• Majors: EUR/USD, GBP/USD, USD/JPY, USD/CHF, AUD/USD, USD/CAD, NZD/USD
• Minors: EUR/GBP, EUR/JPY, GBP/JPY, AUD/JPY, EUR/AUD, etc.
• Exotics: USD/TRY, USD/ZAR, EUR/NOK, etc.

Cryptocurrencies (4+):

• Bitcoin (BTC/USD)
• Ethereum (ETH/USD)
• Litecoin (LTC/USD)
• Bitcoin Cash (BCH/USD)
• Commodities (5+):
• Gold (XAU/USD)
• Silver (XAG/USD)
• Brent Oil (BCO/USD)
• WTI Oil (WTI/USD)
• Natural Gas (NATGAS/USD)

Indices (10+):

• S&P 500 (SPX500/USD)
• NASDAQ (NAS100/USD)
• Dow Jones (US30/USD)
• FTSE 100 (UK100/GBP)
• DAX (GER40/EUR)
• Nikkei (JPN225/JPY)
• More regional indices

Total: 120+ instruments (including all XAU crosses)

Supported Timeframes

Available granularities:

• Monthly: M
• Weekly: W
• Daily: D
• 12-Hour: H12
• 8-Hour: H8
• 6-Hour: H6
• 4-Hour: H4
• 3-Hour: H3
• 2-Hour: H2
• 1-Hour: H1
• 30-Minute: M30
• 15-Minute: M15
• 10-Minute: M10
• 5-Minute: M5
• 1-Minute: M1

Note: Lower timeframes (S5-S15) available but may have higher latency due to data volume.

Technical Indicators

Included in every analysis:

• Bollinger Bands – default values
• SMA (Simple Moving Averages) – multiple periods
• Donchian Channels – default values
• Sentiment Score – Proprietary -100 to +100 scale

Browser & Client Compatibility

Supported AI Clients:

• Claude Desktop and web: v0.5.0+ with Connectors enabled
• ChatGPT Web: Latest version with Apps/Connectors enabled
• Custom MCP clients: Any MCP 1.0 compatible

Supported Browsers (for OAuth):

• Chrome: v110+
• Firefox: v110+
• Safari: v16+
• Edge: v110+
• Brave: v1.50+

Operating Systems:

• macOS: 11 (Big Sur) or later
• Windows: 10 or later
• Linux: Most modern distributions

Not supported:

• Mobile apps (Claude/ChatGPT mobile don’t support MCP yet)
• Internet Explorer
• Browsers with strict privacy settings (may block OAuth)

Token Quotas

AI Model Usage: Your ForexGPT subscription includes AI token quotas which can be consumed from either the web app or via the mcp server:

What uses tokens:

• Technical analysis generation
• Signal interpretation
• Market commentary

What does NOT use tokens:

• Chart data retrieval
• Sentiment scoring
• Market Scans
• Watchlist operations
• Spread checks
• Economic calendar access

Monitoring your usage:

• Dashboard → API Usage → View consumption
• Shows: Requests made, tokens used, remaining quota
• Resets: Monthly on your billing date

Fair Use Policy

We ask that you:

• Don’t abuse rate limits with automated polling
• Don’t share your API token with others
• Don’t resell or redistribute analysis data
• Don’t use ForexGPT data to train competing AI models
• Don’t scrape our platform programmatically outside MCP

We reserve the right to:

• Throttle excessive usage
• Suspend accounts violating terms
• Revoke API access for abuse
• Adjust rate limits for fair access

Examples of abuse:

• ❌ Running 1000 analyses per minute
• ❌ Sharing API token across multiple users
• ❌ Selling ForexGPT analysis as your own service
• ❌ Training AI models on our data

Legitimate high-volume use:

• ✅ Analyzing 50-100 assets per day
• ✅ Running scheduled analysis jobs
• ✅ Integrating ForexGPT into your trading workflow
• ✅ Using data for personal trading research

Need higher limits? Contact [email protected] for Enterprise plans with custom quotas.

Best Practices

1. Effective Prompting

Be specific with your requests:

❌ Weak: "What's happening with the markets?"
✅ Better: "Analyze EUR/USD on the daily chart"
✅ Best: "Analyze EUR/USD on daily and 4-hour charts, then tell me if signals align"

Provide context:

❌ Weak: "Should I buy Gold?"
✅ Better: "I'm considering buying Gold. Analyze XAU/USD on the daily chart."
✅ Best: "I'm considering buying Gold for a swing trade (5-10 day hold). 
         Analyze XAU/USD on daily and 4-hour charts. I need alignment 
         between timeframes before entering."

Ask for what you need:

✅ "Analyze Bitcoin and show me the key support/resistance levels"
✅ "Scan the forex market and find pairs with strong bullish momentum"
✅ "Compare my watchlist on the 4-hour chart and rank by sentiment"
✅ "Get 1000 candles of EUR/USD daily data for backtesting"

2. Watchlist Management

Keep it organized:

• Add assets you actively trade
• Remove assets you’re no longer interested in
• Limit to 15-20 assets for best performance
• Group by asset class in your mind (e.g., majors, crypto, commodities)

Use watchlist for efficiency:

// Instead of:
"Analyze EUR/USD"
"Analyze GBP/USD"
"Analyze USD/JPY"
... [8 more individual requests]

// Do this:
"Add EUR_USD, GBP_USD, USD_JPY... to my watchlist"
"Analyze my watchlist on the 4-hour chart"

Review and update regularly:

"Show me my watchlist"
"Remove LTC_USD and XRP_USD from my watchlist"
"Add AUD_JPY and NZD_JPY to my watchlist"

3. Multi-Timeframe Analysis

Always check multiple timeframes:

✅ "Compare EUR/USD on daily, 4-hour, and 1-hour"

Understand timeframe hierarchy:

• Higher timeframes (Daily, Weekly) = Primary trend
• Lower timeframes (4H, 1H) = Entry timing
• Alignment = Stronger signal

Example workflow:

1. Check daily for trend direction
2. Check 4-hour for intermediate momentum
3. Check 1-hour for precise entry timing
4. Enter when all timeframes align

4. Risk Management

Always ask about risk parameters:

✅ "Analyze EUR/USD and tell me the stop-loss and take-profit levels"
✅ "Calculate my position size for EUR/USD with a $200 risk"
✅ "What's the risk/reward ratio on this GBP/USD setup?"

Check correlations:

✅ "I'm considering EUR/USD and GBP/USD trades. Are they correlated?"
✅ "Analyze EUR/USD, AUD/USD, and USD/JPY for diversification"

Never ignore stop-losses:

• Every ForexGPT signal includes a stop-loss
• Place your stop immediately when entering
• Don’t move stop-loss further away (only trail toward profit)

5. Interpreting Signals

Understand signal strength:

• Don’t blindly follow signals:
• Consider market context (news, fundamentals)
• Check multiple timeframes
• Verify with your own analysis
• Use as confluence, not gospel

Wait for confirmation:

✅ "The daily chart shows bullish sentiment but the 1-hour is neutral. 
    Should I wait for 1-hour confirmation before entering?"

6. Using Economic Calendar

Plan around major events:

✅ "What major economic events are coming this week?"
✅ "Should I hold my EUR/USD trade through tomorrow's NFP release?"

Avoid trading during high-impact news:

• Check calendar before entering trades
• Close or hedge positions before major announcements
• Wait for volatility to settle after news

7. Backtesting & Validation

Get historical data:

✅ "Get me 400 daily candles for EUR/USD"
✅ "Fetch the daily EUR_USD analysis from last week"

Validate strategies:

✅ "Search for recent Bitcoin analyses and show me the win rate"

Learn from past analysis:

✅ "Fetch EUR_USD_D and show me what the signals were"

8. Creating Dashboards

Combine ForexGPT with Claude’s coding:

✅ "Analyze my watchlist on the 4-hour chart and create an HTML 
    dashboard with charts and indicators"
✅ "Get chart data for Bitcoin and create an interactive TradingView 
    chart with support/resistance levels marked"

Save useful dashboards:

• Claude can create reusable HTML files
• Bookmark or save locally
• Refresh data by re-running analysis

9. Learning & Improvement

Ask “why” questions:

✅ "Why is the RSI considered overbought at 70?"
✅ "Explain the MACD crossover signal on EUR/USD"
✅ "What does 'regime: consolidation' mean for my trade?"

Request educational content:

✅ "Explain how to use Fibonacci retracements with an example"
✅ "What's the difference between support and resistance?"
✅ "Show me the latest ForexGPT blog articles about risk management"

10. Security & Privacy

Protect your credentials:

• Never share API tokens
• Don’t paste tokens in public channels
• Revoke tokens when not in use
• Use separate tokens for different purposes

Verify before trading:

• Always double-check analysis results
• Don’t rely solely on AI recommendations
• Verify prices in your broker platform
• Ensure you understand the analysis before acting

• Ask questions
• Share experiences

Documentation

Technical Docs:

• API Reference: [In dashboard, coming soon]
• MCP Protocol Spec: https://modelcontextprotocol.io
• OAuth 2.0 Guide: https://oauth.net/2/

Legal & Compliance

Terms of Service: https://wp.forex-gpt.ai/terms
Privacy Policy: https://wp.forex-gpt.ai/privacy
Risk Disclaimer: https://wp.forex-gpt.ai/risk-warning
Cookie Policy: https://wp.forex-gpt.ai/cookies

Regulatory:

• ForexGPT LLC is not a registered broker-dealer
• Not regulated by SEC, CFTC, or FCA
• Does not hold customer funds
• Provides information services only

Legal Disclaimers

Risk Warning

IMPORTANT: READ THIS CAREFULLY

Trading foreign exchange and cryptocurrencies on margin carries a high level of risk and may not be suitable for all investors. The high degree of leverage can work against you as well as for you. Before deciding to trade foreign exchange, cryptocurrencies, or any other financial instrument, you should carefully consider your investment objectives, level of experience, and risk appetite.

Key risks include:

1. Market Risk – Prices can move against your position, resulting in significant losses
2. Leverage Risk – Leverage magnifies both profits AND losses
3. Liquidity Risk – Inability to exit positions at desired prices
4. Volatility Risk – Rapid price movements can cause substantial losses
5. Technology Risk – System failures may prevent order execution
6. Counterparty Risk – Broker insolvency or default

Statistics you should know:

• 70-80% of retail forex traders lose money
• Leveraged trading can result in losses exceeding your initial deposit

Only trade with money you can afford to lose.

Not Investment Advice

The analysis, signals, data, and information provided through the ForexGPT MCP server are for informational and educational purposes only. They do not constitute:

• Investment advice
• Financial advice
• Trading advice
• Legal advice
• Tax advice
• Any other type of professional advice

Things to avoid when investing or trading:

• Do not treat any content as personalized recommendations
• Do not rely solely on ForexGPT analysis for trading decisions
• Do not make trades without your own independent analysis
• Do not invest funds you cannot afford to lose
• Do not trade without understanding the risks involved

You should:

• Conduct your own research and analysis
• Consult with licensed financial advisors
• Understand the products you’re trading
• Practice with demo accounts first
• Develop a comprehensive trading plan
• Maintain strict risk management

ForexGPT is a tool, not a decision-maker. You are solely responsible for your trading decisions and their outcomes.

Performance Disclaimer

Past performance is not indicative of future results. No representation is being made that any account will or is likely to achieve profits or losses similar to those discussed in any analysis, demonstration, or example.

Hypothetical or simulated performance has inherent limitations:

1. No actual trading – Results are theoretical
2. Benefit of hindsight – Parameters optimized on historical data
3. No slippage – Real trades face execution challenges
4. No emotions – Real trading involves psychological factors
5. Perfect information – Historical data is complete and accurate

Any charts, examples, or demonstrations:

• Are for educational purposes only
• Do not guarantee similar results in real trading
• May not reflect typical performance
• Should not be interpreted as promises of profit

Individual results will vary based on:

• Capital allocated
• Risk management practices
• Trading skill and experience
• Market conditions at time of trade
• Execution quality and timing
• Psychological factors

There is no guarantee that you will achieve any specific level of profitability using ForexGPT.

Third-Party Disclosure

Conflict of Interest Disclosure:

The creator of ForexGPT, Steven Hatzakis, is employed by ForexBrokers.com, a trusted forex broker review and comparison website.

Important clarifications:

1. No Endorsement – This employment relationship does not imply endorsement of ForexGPT by ForexBrokers.com
2. Independent Product – ForexGPT is a separate product offered by ForexGPT LLC
3. No Financial Interest – ForexBrokers.com has no financial stake in ForexGPT LLC
4. Separate Operations – ForexGPT operates independently of ForexBrokers.com
5. Different Purposes – ForexBrokers.com reviews brokers; ForexGPT provides analysis tools

This disclosure is provided for transparency and to avoid any appearance of impropriety.

Additional third-party relationships:

• Market data provided by OANDA (licensed data provider)
• Authentication services by Auth0 (identity platform)
• AI models by OpenAI (Claude and GPT models)
• Economic data, and Charts by TradingView (calendar and charting provider)

Data & Privacy Disclaimer

Data accuracy:

• Market data is provided “as is” without warranty
• Data may be delayed or contain errors
• We are not liable for incorrect or missing data
• Always verify prices with your broker before trading

Privacy commitment:

• We do not store your trading decisions
• We do not share data with third parties (except as required by law)
• We do not sell user data
• See our Privacy Policy for full details

AI Model Disclaimer:

• ForexGPT uses AI models (OpenAI) for analysis generation
• AI outputs may contain errors or biases
• We do not train AI models on your conversations
• AI analysis should not be your sole decision-making tool

Limitation of Liability

To the maximum extent permitted by law:

ForexGPT LLC, its officers, employees, and affiliates shall not be liable for any:

• Direct, indirect, incidental, or consequential damages
• Loss of profits, revenue, or data
• Trading losses or missed opportunities
• System downtime or service interruptions
• Errors in analysis or data
• Unauthorized access to your account

Your sole remedy for dissatisfaction with ForexGPT is to discontinue use and request a refund according to our refund policy.

Maximum liability is limited to the amount you paid for your ForexGPT subscription in the 12 months preceding the claim.

No Broker Relationship

ForexGPT LLC:

• Is NOT a broker-dealer
• Does NOT execute trades on your behalf
• Does NOT hold customer funds
• Does NOT have custodial relationships with traders
• Does NOT receive compensation from brokers for referrals

You must open and maintain your own brokerage account independently. We have no relationship with your broker and are not responsible for their actions or failures.

Regulatory Disclaimer

United States:

• ForexGPT is not registered with the SEC, CFTC, NFA, or any other regulatory body
• We do not provide services that require registration
• We are an information and technology company only

International:

• Regulations vary by jurisdiction
• You are responsible for ensuring compliance with local laws
• Some jurisdictions may prohibit leveraged forex trading
• Check your local regulations before using ForexGPT

If you are unsure whether ForexGPT is legal in your jurisdiction, consult a local attorney.

Changes to Service

We reserve the right to:

• Modify or discontinue the MCP server at any time
• Change pricing or subscription tiers
• Update features and capabilities
• Alter rate limits and quotas
• Modify these terms and conditions

Material changes will be communicated via:

• Email to registered users
• Notice in the dashboard
• Blog post announcement
• 30 days’ advance notice when possible

Continued use after changes constitutes acceptance of new terms.

Entire Agreement

These disclaimers, together with our Terms of Service and Privacy Policy, constitute the entire agreement between you and ForexGPT LLC regarding use of the MCP server.

By using ForexGPT MCP server, you acknowledge that:

• ✅ You have read and understood all disclaimers
• ✅ You accept the risks of trading
• ✅ You will not rely solely on ForexGPT for trading decisions
• ✅ You are responsible for your own trading outcomes
• ✅ You will trade responsibly and within your means

Final Thoughts

The ForexGPT MCP server represents a significant advancement in making sophisticated forex and cryptocurrency analysis accessible through conversational AI interfaces. By combining ForexGPT’s analytical capabilities with the reasoning power of large language models, premium users can conduct market research more efficiently and effectively. ForexGPT is listed in the official MCP registry at https://registry.modelcontextprotocol.io/

What This Technology Enables

Enhanced Research Efficiency:

• Analyze multiple assets simultaneously
• Compare timeframes in seconds
• Discover opportunities across 127+ instruments
• Access real-time data conversationally

Improved Decision-Making:

• Multi-timeframe confluence analysis
• Risk/reward calculations on demand
• Correlation awareness
• Signal strength quantification

Better Learning:

• Interactive technical analysis education
• Explanation of indicator signals
• Market context and commentary
• Pattern recognition assistance

What This Technology Cannot Do

It cannot:

• Guarantee profitable trades
• Replace trading education
• Eliminate emotional challenges
• Make you a professional trader overnight
• Predict the future with certainty

Remember:

• Analysis is only as good as its application
• Discipline trumps indicators
• Risk management is paramount
• Psychology matters more than signals
• Consistent profitability takes time

Our Philosophy

ForexGPT is a research tool, not a replacement for:

• Sound trading education
• Proper risk management
• Disciplined execution
• Psychological preparation
• Professional financial advice

Guidelines for Responsible Use

We encourage all users to:

1. Practice First
   • Use demo accounts before risking real capital
   • Test strategies for at least 3 months
   • Verify signals with your own analysis
   • Build confidence gradually
2. Manage Risk Properly
   • Never risk more than 1-2% per trade
   • Use stop-losses on every trade
   • Diversify across non-correlated assets
   • Maintain appropriate position sizes
   • Keep adequate account reserves
3. Continue Learning
   • Study technical analysis fundamentals
   • Understand market structure
   • Learn from both wins and losses
   • Stay updated on economic events
   • Read trading psychology books
4. Seek Professional Guidance
   • Consult licensed financial advisors
   • Get professional tax advice
   • Understand legal requirements in your jurisdiction
   • Consider financial planning implications
5. Trade Responsibly
   • Never trade with money you cannot afford to lose
   • Avoid emotional decision-making
   • Stick to your trading plan
   • Take breaks after losses
   • Know when to step away

The Reality of Trading

Success in trading requires:

• 📚 Education (20% of success)
• 🎯 Strategy (20% of success)
• 🛡️ Risk Management (30% of success)
• 🧠 Psychology (30% of success)

Notice that 60% of trading success is mental and behavioral, not technical. ForexGPT can help with the technical 40%, but cannot replace the discipline and emotional control required for consistent profitability.

Statistics show:

• Most traders lose money initially
• Profitable traders often lose for 1-2 years before becoming consistent
• Account blow-ups are common among beginners
• Professional traders still have 30-40% losing trades
• Long-term success requires continuous adaptation

Getting Started Safely

Step 1: Demo trading

• Practice for 3-6 months minimum
• Treat demo account like real money
• Track performance rigorously
• Identify and fix mistakes

Step 2: Micro accounts

• Start with smallest position sizes
• Risk only 0.5% per trade initially
• Focus on process over profits
• Build confidence gradually

Step 3: Scale carefully

• Increase size only after consistent profitability
• Never rush into larger positions
• Maintain conservative risk per trade
• Prioritize capital preservation

Step 4: Continuous improvement

• Review every trade (wins and losses)
• Keep a trading journal
• Update strategy as needed
• Stay humble and adaptable

Ready to Begin?

If you’ve read this entire document and understand the risks involved, you’re ready to set up ForexGPT MCP access.

Next steps:

1. ✅ Verify your premium subscription is active
2. ✅ Follow the setup instructions for your AI client
3. ✅ Test with simple queries first
4. ✅ Explore the tools gradually
5. ✅ Practice with demo accounts
6. ✅ Trade responsibly and within your means

Log in to your ForexGPT dashboard and begin: https://live4.forex-gpt.ai/dashboard

About ForexGPT

ForexGPT LLC is a financial technology company specializing in AI-powered market analysis tools for forex and cryptocurrency traders. Founded in 2023, we combine cutting-edge AI technology with professional trading expertise to make sophisticated market analysis accessible to retail traders.

Our Mission: Democratize access to institutional-grade market analysis through AI technology, while promoting responsible trading education and risk management.

Contact Information:

• Website: https://wp.forex-gpt.ai
• Email: [email protected]
• Dashboard: https://live4.forex-gpt.ai
• MCP Server: https://mcp.forex-gpt.ai

Legal Entity: ForexGPT LLC
Registered in the United States
Not a registered broker-dealer or investment advisor

Disclaimer: This document and the ForexGPT service do not constitute investment advice. Trading involves substantial risk of loss. Only trade with risk capital. Past performance is not indicative of future results. Always consult with licensed financial professionals before making trading decisions.

© 2023-2026 ForexGPT LLC. All rights reserved.

This document is provided for informational purposes only. Trading financial instruments involves risk. See full disclaimer above.