# ForexGPT MCP
> Forex and multi-asset market analysis MCP with live market data, watchlists, and optional OANDA account/order operations.
Canonical: https://www.mcpfolio.com/servers/forex-gpt
Last updated: 2026-10-28
## Catalog record

- Publisher: ForexGPT LLC
- Categories: productivity, search, finance

## Website

https://forex-gpt.ai/

## Transports

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

## 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.

## Tools

- **scan_market**: Scans entire market universe (Forex, Crypto, Metals, Indices) to find strongest trading opportunities ranked by sentiment strength.
- **get_live_heatmap**: Generates real-time sentiment heatmap snapshot. Uses provided assets, user's watchlist, or default popular assets.
- **search**: Search forex analysis results by asset name, timeframe, or keywords.
- **list_assets**: Returns supported asset symbols from OANDA universe. Can filter by substring or test specific asset.
- **get_blog_articles**: Get recent articles from the Forex-GPT blog feed.
- **analyze_asset**: Run comprehensive one-shot technical analysis for a single asset/timeframe combination. Requires subscription tokens.
- **analyze_timeframes**: Analyze a single asset across multiple timeframes simultaneously for confluence. Requires subscription tokens.
- **analyze_watchlist**: Analyze all assets in user's saved watchlist in parallel. Requires subscription tokens.
- **fetch**: Retrieve complete pre-computed forex analysis by ID.
- **chart_chat_proxy**: Proxy to Flask chart-chat endpoint for AI-powered chart analysis.
- **get_chart_data**: Retrieve OHLC candlestick data for charting purposes.
- **get_spreads**: Check current liquidity and trading cost (spread) for an asset.
- **economic_events**: Fetch upcoming economic events via TradingView proxy.
- **get_price_stream_url**: Get short-lived URL for real-time price streaming (SSE). Requires OANDA credentials.
- **get_sentiment_stream_url**: Get short-lived URL for real-time sentiment streaming (SSE).
- **get_server_time**: Return the server's current UTC timestamp.
- **get_watchlist**: View current assets in your saved watchlist.
- **add_to_watchlist**: Add a new asset to your persistent watchlist.
- **remove_from_watchlist**: Remove an asset from your persistent watchlist.
- **save_oanda_credentials**: Securely save your OANDA API Key and Account ID. Required before any trading.
- **delete_oanda_credentials**: Remove your stored OANDA API Key and Account ID.
- **get_trading_account**: Get trading account summary including balance, margin, and P&L. Requires OANDA credentials.
- **get_account_history**: Get account transaction history (closed trades, order fills, etc.). Requires OANDA credentials.
- **trade_market_order**: Place an immediate market order. Positive units = BUY, Negative units = SELL. Supports trailing stop and guaranteed stop loss. Requires OANDA credentials.
- **trade_limit_order**: Place a pending limit order at a specific price. Requires OANDA credentials.
- **trade_stop_order**: Place a pending stop order (Buy Stop or Sell Stop). Triggers when price reaches level. Requires OANDA credentials.
- **trade_modify_trade**: Modify Stop Loss and Take Profit of an existing open trade. Requires OANDA credentials.
- **cancel_pending_order**: Cancel a specific pending order (Limit or Stop) that hasn't triggered yet. Requires OANDA credentials.
- **replace_pending_order**: Modify a pending order by replacing it with a new one. Requires OANDA credentials.
- **get_pending_orders**: List all pending orders waiting to be filled. Requires OANDA credentials.
- **get_order_history**: Get a list of historical orders. Requires OANDA credentials.
- **get_open_trades**: List all currently open trade tickets. Requires OANDA credentials.
- **get_open_positions**: List net exposure per instrument (Long vs Short units). Requires OANDA credentials.
- **get_trade_details**: Get full details of a specific trade (open or closed). Requires OANDA credentials.
- **close_trade**: Close a specific trade (fully or partially). Requires OANDA credentials.
- **close_position**: Flatten entire exposure for a specific instrument. Requires OANDA credentials.
- **get_instrument_specs**: Get instrument specifications (pip value, margin, trading hours).
- **get_market_hours**: Get current market trading hours by region.
- **is_market_open**: Check if a specific instrument is currently tradeable.
- **refresh_instrument_data**: Refresh cached instrument information from OANDA.
- **get_instrument_cache_status**: View the status of the instrument data cache.
- **health**: Comprehensive health check with optional upstream dependency verification.
- **help_tutorial**: Master tutorial for MCP tools with usage tips and suggested flows.
- **get_token_balances**: Return current user's token balances from account.

## Sources

- [official_vendor_tool_reference](https://forex-gpt.ai/api-mcp-support/)
- [official_setup_guide](https://forex-gpt.ai/mcp-tutorial/)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/forex-gpt) to view instructions for each supported client.