MCP serverio.github.hatgit/forex-gpt-mcp

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

Approve a pending agent action (trade entry, exit, modification). Args: action_id: The pending action ID to approve adjust_sl: Optional ad

Get historical performance and actions for an agent. Args: agent_id: Specific agent, or omit for all agents days: Number of days of histor

Link your Telegram account to receive agent notifications. To get your Telegram chat ID: 1. Open Telegram and search for @userinfobot 2. Start the

List all available trading strategies with descriptions. Returns information about each strategy including: - Recommended timeframes and instruments

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)

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

Reject a pending agent action. Args: action_id: The pending action ID to reject reason: Optional reason for rejection (helps agent learn)

Start an autonomous trading agent with specified strategy. This creates a new agent that will scan markets, analyze opportunities, and trade (or request a

Get status of one or all your agents. Args: agent_id: Specific agent ID, or omit for all agents Returns: Agent status including P

Stop a running agent. Args: agent_id: The agent ID to stop close_positions: If True, close all positions opened by this agent

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

Analyze a single asset across multiple timeframes simultaneously. Args: asset: Asset symbol (e.g., EUR_USD) timeframes: List of timeframes (e.g., ["D"

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 (m

List recent backtest runs, optionally filtered by instrument. Args: instrument: Filter by instrument (optional) limit: Max results (1-50).

List saved parameter presets, optionally filtered by instrument. Args: instrument: Filter by instrument (optional) Returns: List

Grid search optimization to find the best parameter set for an instrument. Tests all combinations of sentiment_threshold, SL distance, and tp_multiplier a

Run a backtest on historical data using sentiment-based signals. Uses the same deterministic sentiment scoring as the live scanner (Bollinger Bands + SMA

Save a backtest's parameters as a reusable preset. Args: backtest_id: The backtest run ID to save params from name: Name for this paramete

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

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.

Close position for an instrument.

Close a specific trade (fully or partially).

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

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 (

Retrieve complete forex analysis by ID. Args: id: Analysis ID in format "ASSET_TIMEFRAME" (e.g., "EUR_USD_D", "XAU_USD_H4") Returns: Full ana

Get account transaction history (e.g. closed trades, order fills). Useful for finding past trades, reporting, or auditing. Args: from_time: Start time (RFC3339

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

Retrieve OHLC (candlestick) data for charting. Args: asset: Asset symbol (e.g., EUR_USD) timeframe: Timeframe (D, H4, H1, etc.) count: Number

Aggregated crypto-news feed from quality free RSS sources (CoinDesk, Decrypt, Blockworks, The Defiant). Sorted newest-first, deduped by URL across sources. Args:

Generates a real-time Sentiment Heatmap snapshot. Behavior: 1. If 'assets' are provided, scans those specific assets. 2. If 'assets' not provided, scans the u

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

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

List open trades.

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.

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:

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.

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

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

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

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

Get trading account summary (balance, margin).

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

Comprehensive health and status check including optional upstream dependencies. Args: checkOpenAI: Verify OpenAI API connectivity checkTradingView: Ve

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

Return supported asset symbols for the active broker. For OANDA containers: returns the OANDA universe (~120 instruments). For Hyperliquid containers: returns the Hyp

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 to

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_tok

Manually refresh instrument data from OANDA API. Updates financing rates, margin requirements, and other parameters. Requires: User must have saved OANDA credenti

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

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.

Generate a short AI briefing (one paragraph + three bullets) from the terminal's current research context: watchlist Sentiment Scores, running agents and t

Save broker credentials. Supports multiple brokers. Args: broker: The broker name - "oanda", "etoro", or "hyperliquid" api_key: Your broker API key (OANDA

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

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

Search forex analysis results by asset name, timeframe, or keywords. Returns a list of available analyses matching the search criteria. Args: query: Searc

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_prof

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_profi

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: t

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')

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 x

Return the public Solana x402 config: recipient pubkey, supported networks (with USDC mints + RPC URLs), and the token package. No authentication required — every val