Forex-GPT MCP Server

Save your OANDA API Key and Account ID securely. These are required before you can trade.

Remove/Delete your stored OANDA API Key and Account ID. Use this if you want to clear your credentials or switch accounts.

No parameters. Call it with no arguments.

Save broker credentials. Supports multiple brokers. Args: broker: The broker name - "oanda", "etoro", or "hyperliquid" api_key: Your broker API key (OANDA/eToro). NOT used for Hyperliquid (see below). account_id: Your broker account ID (required for OANDA) user_key: Your eToro...

Modify an existing trade's Stop Loss and Take Profit. You can use absolute prices OR relative distances. Only provided fields will be updated. Args: trade_id: The ID of the open trade to modify. take_profit: New ABSOLUTE price. stop_loss: New ABSOLUTE price. take_profit_distan...

Place a Market Order. units: Positive for Buy, Negative for Sell take_profit: ABSOLUTE PRICE (e.g. 1.1250). stop_loss: ABSOLUTE PRICE (e.g. 1.1100). take_profit_distance: RELATIVE PIPS (e.g. 0.0050). Use this OR absolute price. stop_loss_distance: RELATIVE PIPS (e.g. 0.0020)....

Place a Limit Order. price: The limit price to trigger the order. take_profit: ABSOLUTE PRICE (e.g. 1.1250). stop_loss: ABSOLUTE PRICE (e.g. 1.1100). take_profit_distance: RELATIVE PIPS (e.g. 0.0050). stop_loss_distance: RELATIVE PIPS (e.g. 0.0020). trailing_stop_distance: REL...

Place a Stop Order (Momentum/Breakout Entry). Use this to Buy ABOVE market price or Sell BELOW market price. Args: instrument: Asset symbol (e.g. 'EUR_USD') units: Positive for Buy, Negative for Sell price: The STOP price to trigger the order. expiry: ISO 8601 string (e.g. "20...

Cancel a pending (unfilled) Limit or Stop order. Args: order_id: The OANDA ID of the order to cancel.

Replace (Modify) an existing pending order. Basically cancels the old one and places a new one atomically. Args: order_id: ID of the order to replace. type: 'LIMIT' or 'STOP'. client_nonce: Optional. 32-char hex idempotency token for the new order. Pass the same value from a p...

List open trades.

No parameters. Call it with no arguments.

List open positions (Net Exposure per instrument). Useful to see total Long/Short units and P&L per pair.

No parameters. Call it with no arguments.

Get account transaction history (e.g. closed trades, order fills). Useful for finding past trades, reporting, or auditing. Args: from_time: Start time (RFC3339 format, e.g. "2023-05-01T00:00:00Z"). to_time: End time (RFC3339). type_filter: Comma-separated types (e.g. "ORDER_FI...

Get full details of a specific trade (Open or Closed). Useful to investigate a trade that disappeared or to see its full history.

Trading-performance aggregates: realized P&L net of fees, total fees paid, perp funding paid/received, fill count, plus a daily breakdown for the chart. Args: window: "7d" | "30d" | "90d" | "ytd" | "all" (default). Filters fills + funding by their HL timestamp. Lifetime totals...

Get OANDA order history (FILLED, CANCELLED, TRIGGERED, etc.). state: "ALL", "PENDING", "FILLED", "TRIGGERED", "CANCELLED". count: Max 500.

List all PENDING orders (Limits, Stops, Entry Orders). These are orders waiting to be filled.

No parameters. Call it with no arguments.

Get trading account summary (balance, margin).

No parameters. Call it with no arguments.

Close a specific trade (fully or partially).

Close position for an instrument.

No parameters. Call it with no arguments.

Manually refresh instrument data from OANDA API. Updates financing rates, margin requirements, and other parameters. Requires: User must have saved OANDA credentials via save_oanda_credentials. Returns: - success: Boolean indicating if refresh succeeded - message: Status messa...

No parameters. Call it with no arguments.

No parameters. Call it with no arguments.

Return the current user's token balances from Auth0 app_metadata. Uses _safe_profile() so that the same values shown inside AI analysis (token_quota, purchased_tokens, total_token_usage, last_reset, email, user_id) are returned in a simple JSON structure.

No parameters. Call it with no arguments.

Return supported asset symbols for the active broker. For OANDA containers: returns the OANDA universe (~120 instruments). For Hyperliquid containers: returns the Hyperliquid perp universe (~230 markets) with per-asset metadata (current price, max leverage, funding rate, open...

Top gainers, top losers and (Hyperliquid) top 24h volume across the active broker's whole universe, ranked by daily price change. No Sentiment Score is computed and no tokens are charged — use scan_market for score rankings. Hyperliquid: rolling 24h change from the exchange's...

Run a one-shot technical analysis for a SINGLE asset on a SINGLE timeframe. Use this when the user asks about ONE specific asset by name, e.g.: - "analyze EUR_USD" - "give me your read on BTC on the 4-hour" - "what's the signal on gold?" - "deep analysis on SOL/USDC daily" For...

View the assets the user has SAVED to their persistent watchlist. Use this when the user asks about their watchlist, e.g.: - "show my watchlist" - "what's on my watchlist" - "list my watchlist" - "what assets am I watching" This is NOT the same as open positions / trades. The...

No parameters. Call it with no arguments.

Add a new asset to your persistent watchlist. Args: asset: Asset symbol (e.g. 'EUR_USD', 'BTC_USD')

Remove an asset from your persistent watchlist. Args: asset: Asset symbol to remove

Analyze multiple assets from the user's SAVED watchlist in parallel. Args: timeframe: Timeframe (D, H4, H1, etc.) priceType: B (bid), A (ask), or M (mid) timeoutSec: Overall timeout in seconds (30-300) (optional) timeframes: list of timeframes (timeframes mode) – if provided,...

Analyze a single asset across multiple timeframes simultaneously. Args: asset: Asset symbol (e.g., EUR_USD) timeframes: List of timeframes (e.g., ["D", "H4", "H1"]) priceType: B (bid), A (ask), or M (mid) timeoutSec: Overall timeout in seconds (30-300) Returns: Multi-timeframe...

Fetch upcoming economic events via the TradingView proxy source. Args: fromDays: Start of date range (days from now, 0-90) toDays: End of date range (days from now, 0-90) Returns: List of economic events with importance, country, and timing

Get recent articles from the Forex-GPT blog feed. Args: max_results: Maximum number of articles to return (1-50, default: 10) category: Optional category slug to filter by. When unset, the tool falls back to a broker-aware default: - hyperliquid containers → "daily-crypto-hype...

Aggregated crypto-news feed from quality free RSS sources (CoinDesk, Decrypt, Blockworks, The Defiant). Sorted newest-first, deduped by URL across sources. Args: max_results: 1-50, default 25. ticker: Optional symbol filter (e.g. "BTC", "ETH", "SOL", "HYPE"). When set, only ar...

Comprehensive health and status check including optional upstream dependencies. Args: checkOpenAI: Verify OpenAI API connectivity checkTradingView: Verify TradingView API connectivity checkOANDA: Verify OANDA API connectivity Returns: Health status with environment info and de...

Retrieve OHLC (candlestick) data for charting. Args: asset: Asset symbol (e.g., EUR_USD) timeframe: Timeframe (D, H4, H1, etc.) count: Number of candles (50-5000) Returns: Candlestick data with timestamps, open, high, low, close prices

Purchase premium tokens via X402 crypto payment. Pay $20 USDC to receive 500,000 premium tokens (non-expiring). These tokens can be used to access all ForexGPT tools and services. Args: payment_proof: X402 payment proof containing signature and payment details. Must include: a...

Return the public Solana x402 config: recipient pubkey, supported networks (with USDC mints + RPC URLs), and the token package. No authentication required — every value here is broadcast publicly on-chain at payment time anyway. The frontend calls this on the payment modal's m...

No parameters. Call it with no arguments.

Return the public EVM x402 config: recipient address, supported networks (CAIP-2 keys → USDC contract + RPC URL + chain name), and the token package. Pairs with x402_solana_config so the WalletPaymentModal can render a Solana | EVM tab switcher and let the user pay from whiche...

No parameters. Call it with no arguments.

Purchase premium tokens via X402 payment on Solana. Pay $20 USDC on Solana (devnet or mainnet) to receive 500,000 premium tokens. Credits go to the same purchased_tokens balance used by the Stripe and EVM rails — one balance, three rails. Two accepted proof shapes: signed_auth...

Generates a real-time Sentiment Heatmap snapshot. Behavior: 1. If 'assets' are provided, scans those specific assets. 2. If 'assets' not provided, scans the user's saved Watchlist. 3. If Watchlist is empty, scans a default list of popular global assets. Args: assets: Optional...

Search forex analysis results by asset name, timeframe, or keywords. Returns a list of available analyses matching the search criteria. Args: query: Search query (e.g., "EUR_USD", "daily analysis", "gold", "bitcoin") Returns: Search results with IDs for fetching full analysis

Retrieve complete forex analysis by ID. Args: id: Analysis ID in format "ASSET_TIMEFRAME" (e.g., "EUR_USD_D", "XAU_USD_H4") Returns: Full analysis document with technical indicators, signals, and recommendations

Scans the FULL market universe (Forex, Crypto, Metals, Indices) and returns the top trading opportunities ranked by sentiment score. Use this when the user asks for a MULTI-ASSET survey or anything that implies scanning / finding opportunities across the market. Example user p...

Checks the current liquidity and trading cost (spread) for an asset. Useful for checking if a market is too expensive to trade right now. Args: asset: The asset symbol (e.g., "EUR_USD", "XAU_USD") Returns: Current spread, average spread, and cost in basis points.

Return the server's current UTC timestamp (ISO 8601).

No parameters. Call it with no arguments.

Master tutorial for MCP tools: usage tips, key parameters, and suggested flows.

No parameters. Call it with no arguments.

Return a short-lived URL for the raw price stream (SSE) for given instruments. The URL expires after ~10 minutes.

Return a short-lived URL for the sentiment stream (SSE) for given instruments and granularity. The URL expires after ~10 minutes.

Proxy to the Flask /api/chart-chat endpoint using the caller's bearer token. Keeps token accounting/auth consistent with the web app while exposing chat via MCP.

Start an autonomous trading agent with specified strategy. This creates a new agent that will scan markets, analyze opportunities, and trade (or request approval) based on your configuration. Args: strategy: Strategy type - "swing", "scalper", "news_trader", "trend_follower",...

+7 more parameters. See the server's own documentation for the full schema.

Stop a running agent. Args: agent_id: The agent ID to stop close_positions: If True, close all positions opened by this agent cancel_pending: If True, cancel all pending orders from this agent Returns: Confirmation of agent stop and any actions taken Example: "Stop agent abc12...

Get status of one or all your agents. Args: agent_id: Specific agent ID, or omit for all agents Returns: Agent status including P&L, open positions, pending approvals Example: "What is my agent doing?" or "Show status of agent abc123"

Approve a pending agent action (trade entry, exit, modification). Args: action_id: The pending action ID to approve adjust_sl: Optional adjusted stop-loss price adjust_tp: Optional adjusted take-profit price adjust_size: Optional adjusted position size (units) Returns: Result...

Reject a pending agent action. Args: action_id: The pending action ID to reject reason: Optional reason for rejection (helps agent learn) pause_agent: If True, pause the agent after rejection Returns: Confirmation of rejection Example: "Reject that trade, the spread is too hig...

Modify a running agent's parameters. Args: agent_id: The agent ID to modify risk_per_trade: New risk per trade percentage (0.1-5.0) max_positions: New maximum concurrent positions (1-10) control_level: New control level ("manual", "supervised", "semi_auto", "full_auto") scan_i...

+2 more parameters. See the server's own documentation for the full schema.

List all available trading strategies with descriptions. Returns information about each strategy including: - Recommended timeframes and instruments - Typical hold times - Risk profile - Minimum scan interval Example: "What trading strategies can the agent use?"

No parameters. Call it with no arguments.

Get historical performance and actions for an agent. Args: agent_id: Specific agent, or omit for all agents days: Number of days of history (1-90). Default: 7 include_cycles: Include detailed scan cycle logs include_trades: Include trade history. Default: True limit: Max trade...

Link your Telegram account to receive agent notifications. To get your Telegram chat ID: 1. Open Telegram and search for @userinfobot 2. Start the bot and it will show your ID 3. Copy the number and use it here Args: telegram_chat_id: Your Telegram chat ID (a number like "1234...

View your notification settings and linked accounts. Returns: Your current notification preferences and linked services Example: "Show my notification settings"

No parameters. Call it with no arguments.

Run a backtest on historical data using sentiment-based signals. Uses the same deterministic sentiment scoring as the live scanner (Bollinger Bands + SMA alignment) to generate buy/sell signals when abs(score) >= threshold. Distance mode is automatic: forex/OANDA instruments u...

Grid search optimization to find the best parameter set for an instrument. Tests all combinations of sentiment_threshold, SL distance, and tp_multiplier and ranks results by the chosen metric. On forex/OANDA the SL grid is sl_pips_range (pips); on Hyperliquid, where pips are m...

Save a backtest's parameters as a reusable preset. Args: backtest_id: The backtest run ID to save params from name: Name for this parameter set (e.g. "EUR_USD H4 aggressive") Returns: Saved parameter set details Example: "Save those backtest params as 'EUR_USD H4 optimal'"

List saved parameter presets, optionally filtered by instrument. Args: instrument: Filter by instrument (optional) Returns: List of saved parameter sets Example: "Show my saved backtest params" or "Show saved params for EUR_USD"

List recent backtest runs, optionally filtered by instrument. Args: instrument: Filter by instrument (optional) limit: Max results (1-50). Default: 20 Returns: List of recent backtest runs with summary stats Example: "Show my backtest history" or "Show backtests for XAU_USD"

Generate a short AI briefing (one paragraph + three bullets) from the terminal's current research context: watchlist Sentiment Scores, running agents and their theses, open positions, upcoming events / headlines and the latest research article. Charged to the user's tokens lik...