Skip to directory

ForexGPT MCP

ForexGPT LLC

HTTP+WebSocket (as stated in vendor technical table; current MCP client transport compatibility not independently tested)44+ documented tools6

About ForexGPT MCP

Forex and multi-asset market analysis MCP with live market data, watchlists, and optional OANDA account/order operations.

What you can use it for

  • Review market price/candlestick data and spreads.
  • Analyze an instrument or compare multiple timeframes.
  • Review economic events and historical research.
  • Manage a saved watchlist.
  • Access OANDA demo-account tools only when deliberately configured.
Connection and setup
Hosting
remote, hosted
Transport
HTTP+WebSocket (as stated in vendor technical table; current MCP client transport compatibility not independently tested)
Endpoint
https://mcp.forex-gpt.ai/mcp
Authentication
Vendor currently documents OAuth 2.0 or a dashboard-generated personal API token. The page has conflicting plan language: its overview says premium subscribers and its prerequisites say free tier is unsupported; verify eligibility in the account.

Requirements

  • ForexGPT account; integration guide says Premium subscription required, while the same page footer advertises a free account with daily tokens. Exact MCP entitlement is conflicting and should be confirmed in the dashboard.
  • Internet access.
  • OANDA demo account/API credentials only for OANDA trading tools; vendor warns these credentials provide account access.

Setup steps

  1. Confirm the account plan currently includes MCP access; the vendor integration page conflicts between premium-only prerequisites and free-account daily tokens.
  2. Add https://mcp.forex-gpt.ai/mcp as a remote MCP connector in a supported client.
  3. Follow the client's browser-based ForexGPT OAuth authorization flow. For Claude, the vendor's separate setup article says a unique magic link may be required from the beta dashboard.
  4. For token-based clients, sign in at https://live4.forex-gpt.ai/dashboard, create an API token in API Access, and store it in local secret storage. The vendor says tokens last 90 days and provide full account access.
  5. If using OANDA-specific account tools, connect an OANDA demo account and use its API credential only through the service's documented secure credential tool flow.
  6. First verify with a read-only tool such as list_assets or get_chart_data. Do not invoke order placement/modification/cancellation tools without explicit user confirmation; these can change brokerage account state.
Tools 44+

The current vendor reference claims 45 tools but exposes 44 distinct tool headings in its published All Tools Reference. All 44 names are captured here; one claimed tool is not named in the page. This is not a live tools/list snapshot. The set includes OANDA account and order-management tools, which may perform consequential trading actions.

  • scan_market

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

    01
  • get_live_heatmap

    Generates real-time sentiment heatmap snapshot. Uses provided assets, user's watchlist, or default popular assets.

    02
  • search

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

    03
  • list_assets

    Returns supported asset symbols from OANDA universe. Can filter by substring or test specific asset.

    04
  • get_blog_articles

    Get recent articles from the Forex-GPT blog feed.

    05
  • analyze_asset

    Run comprehensive one-shot technical analysis for a single asset/timeframe combination. Requires subscription tokens.

    06
  • analyze_timeframes

    Analyze a single asset across multiple timeframes simultaneously for confluence. Requires subscription tokens.

    07
  • analyze_watchlist

    Analyze all assets in user's saved watchlist in parallel. Requires subscription tokens.

    08
  • fetch

    Retrieve complete pre-computed forex analysis by ID.

    09
  • chart_chat_proxy

    Proxy to Flask chart-chat endpoint for AI-powered chart analysis.

    10
  • get_chart_data

    Retrieve OHLC candlestick data for charting purposes.

    11
  • get_spreads

    Check current liquidity and trading cost (spread) for an asset.

    12
  • economic_events

    Fetch upcoming economic events via TradingView proxy.

    13
  • get_price_stream_url

    Get short-lived URL for real-time price streaming (SSE). Requires OANDA credentials.

    14
  • get_sentiment_stream_url

    Get short-lived URL for real-time sentiment streaming (SSE).

    15
  • get_server_time

    Return the server's current UTC timestamp.

    16
  • get_watchlist

    View current assets in your saved watchlist.

    17
  • add_to_watchlist

    Add a new asset to your persistent watchlist.

    18
  • remove_from_watchlist

    Remove an asset from your persistent watchlist.

    19
  • save_oanda_credentials

    Securely save your OANDA API Key and Account ID. Required before any trading.

    20
  • delete_oanda_credentials

    Remove your stored OANDA API Key and Account ID.

    21
  • get_trading_account

    Get trading account summary including balance, margin, and P&L. Requires OANDA credentials.

    22
  • get_account_history

    Get account transaction history (closed trades, order fills, etc.). Requires OANDA credentials.

    23
  • trade_market_order

    Place an immediate market order. Positive units = BUY, Negative units = SELL. Supports trailing stop and guaranteed stop loss. Requires OANDA credentials.

    24
  • trade_limit_order

    Place a pending limit order at a specific price. Requires OANDA credentials.

    25
  • trade_stop_order

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

    26
  • trade_modify_trade

    Modify Stop Loss and Take Profit of an existing open trade. Requires OANDA credentials.

    27
  • cancel_pending_order

    Cancel a specific pending order (Limit or Stop) that hasn't triggered yet. Requires OANDA credentials.

    28
  • replace_pending_order

    Modify a pending order by replacing it with a new one. Requires OANDA credentials.

    29
  • get_pending_orders

    List all pending orders waiting to be filled. Requires OANDA credentials.

    30
  • get_order_history

    Get a list of historical orders. Requires OANDA credentials.

    31
  • get_open_trades

    List all currently open trade tickets. Requires OANDA credentials.

    32
  • get_open_positions

    List net exposure per instrument (Long vs Short units). Requires OANDA credentials.

    33
  • get_trade_details

    Get full details of a specific trade (open or closed). Requires OANDA credentials.

    34
  • close_trade

    Close a specific trade (fully or partially). Requires OANDA credentials.

    35
  • close_position

    Flatten entire exposure for a specific instrument. Requires OANDA credentials.

    36
  • get_instrument_specs

    Get instrument specifications (pip value, margin, trading hours).

    37
  • get_market_hours

    Get current market trading hours by region.

    38
  • is_market_open

    Check if a specific instrument is currently tradeable.

    39
  • refresh_instrument_data

    Refresh cached instrument information from OANDA.

    40
  • get_instrument_cache_status

    View the status of the instrument data cache.

    41
  • health

    Comprehensive health check with optional upstream dependency verification.

    42
  • help_tutorial

    Master tutorial for MCP tools with usage tips and suggested flows.

    43
  • get_token_balances

    Return current user's token balances from account.

    44

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

Limitations and notes
  • Documentation labels service beta/live and gives conflicting account-plan requirements; confirm current access before setup.
  • Embedded technical specification reports server version 2.0.0 while top-level guide reports 2.0.1-enhanced.
  • Authentication docs describe OAuth and API tokens; a separate setup article states Claude may require a beta-dashboard magic link.
  • Trading-related tools can place/modify/cancel orders or affect open positions. Do not treat the MCP as read-only.
  • Vendor states analysis is informational, not investment advice, and ForexGPT is not a broker or investment adviser.
  • No connection test performed.
  • The official page claims 45 tools but contains 44 distinct named tool headings; one tool name is missing from the published reference.
  • Trading and OANDA account tools can place, change, cancel, or close orders and positions. Treat these as consequential operations.
Source discrepancies
  • Integration guide header says active Premium subscription required and free tier unsupported, while its footer advertises a free account with daily tokens; entitlement is not resolved.
  • Guide heading reports version 2.0.1-enhanced, while embedded technical specification reports server version 2.0.0.
  • Quickstart describes OAuth and API token; separate client instructions say Claude requires a dashboard-generated beta magic link.
  • Embedded technical table calls transport HTTP+WebSocket, but endpoint examples and modern client setup describe an HTTP MCP URL; no client-side compatibility test performed.
Original sources
  • official vendor tool reference

    Current official integration guide claims 45 tools; its All Tools Reference section has 44 distinct named tool headings. Tool names and short descriptions are transcribed from the 44 visible entries; includes OANDA trading operations.

  • official setup guide

    Vendor setup tutorial describes supported clients, OAuth connection, free and premium tool distinctions; account-access statements are not fully consistent across vendor pages.

Documentation checked 2026-10-28T14:10:00.000Z. Connection has not been runtime tested.