Forex-GPT MCP Server

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"

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 meaningless for crypto perps, it is sl_pct_range (% of price). Args: instrument: Instrument (e.g. EUR_USD, XAU_USD; BTC on Hyperliquid) timeframe: Candle granularity. Default: H1 count: Historical candles to fetch (100-5000). Default: 50…

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 use pips (sl_pips/spread_pips); on Hyperliquid, where pips are meaningless for crypto perps, SL and spread are a percent of price (sl_pct/spread_pct) and trade "pips" figures are percent moves. Args: instrument: Instrument (e.g. EUR_USD…

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

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 (days from now, 0-90) Returns: List of economic events with importance, country, and timing

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

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_FILL,TRADE_CLOSE"). To see closed trades, use "TRADE_CLOSE".

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" (ID 24) so HL users see only crypto-focused content, not the forex daily AI analysis stream. - Anything else → site-wide feed. Pass an explicit slug (e.g. "daily-deep-dive", "the-weekly-open") to ove…

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

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 articles mentioning the ticker (case-insensitive substring match in title OR summary) are returned. Pass "all" or empty to disable filtering. Returns: {status, count, ticker, articles: [{title, url, summary, published, source, image?}…

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 list of symbols. timeframe: Granularity (e.g. 'H1', 'D').

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 own reference price, plus 24h notional volume. OANDA: current daily candle vs the prior close. Args: limit: rows per list (1-50, default 25). liquid_only: Hyperliquid only — rank gainers/losers within the 100 most-traded markets by 24h notional so thin markets don't d…

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: window: "7d" | "30d" | "90d" | "ytd" | "all" (default). Filters fills + funding by their HL timestamp. Lifetime totals are always returned alongside the windowed slice.

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 asset symbol (e.g., "EUR_USD", "XAU_USD") Returns: Current spread, average spread, and cost in basis points.

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.

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 on my watchlist" - "list my watchlist" - "what assets am I watching" This is NOT the same as open positions / trades. The watchlist is a saved list of asset SYMBOLS the user follows; it has no balance, P&L, units, or entry-price data. For open positions use get_open_positions; for open trades use get_open_trades. Do NOT call get_open_positions or get_open_trades for watchlist que…

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 dependency checks

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 Hyperliquid perp universe (~230 markets) with per-asset metadata (current price, max leverage, funding rate, open interest, 24h volume, product_type, sector, is_pre_launch, is_hip3). When ``include_spot=True`` (default), the spot universe from ``/info{spotMeta}`` is appended — instruments tagged ``product_type="spot"`` use ``_USDC`` suffix so they don't collide with perp canonical names. Opt…

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: amount, token, network, nonce, v, r, s, from, to, validAfter, validBefore Returns: Success message with new token balance or payment required error. Example payment_proof: { "type": "eip3009", "amount": "20000000", # $20…

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_authorization (off-chain Ed25519 sig over a canonical message): { "type": "signed_authorization", "network": "solana:devnet", "token": "USDC", "from": "<signer pubkey base58>", "to": "<treasury pubkey base58>", "amount": "20000…

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 message - count: Number of instruments refreshed - refreshedAt: Timestamp of refresh Note: This fetches fresh data from OANDA's practice environment. The cache is automatically refreshed on server startup if data is >24 hours old.

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. type: 'LIMIT' or 'STOP'. client_nonce: Optional. 32-char hex idempotency token for the new order. Pass the same value from a prior call's response to retry safely. Server mints one if absent. (All other args same as placement tools)

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 like any AI analysis (1 token = 1 LLM token); refused when the balance can't cover it. Args: context: JSON assembled by the terminal — keys: pulse, agents, positions, events, headlines, article, network, broker.

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 user key (required for eToro) demo_mode: Use demo/virtual portfolio (eToro only, default True) Note for Hyperliquid users: Hyperliquid does not use API keys. Instead you connect a self-custody Web3 wallet and authorize a trading agent via an on-chain EIP-712 …

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 MULTI-ASSET survey or anything that implies scanning / finding opportunities across the market. Example user phrasings that should trigger scan_market: - "scan the market" - "scan market on daily for score of 85" - "what's bullish on the H4?" - "find me strong setups" - "show top opportunities" - "what looks bearish right now?" - "any crypto setups?" …

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

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: RELATIVE DISTANCE for trailing stop. guaranteed_stop_loss: True for GSLO. expiry: ISO 8601 string (e.g. "2023-12-31T23:59:00Z"). Defaults to GTC if omitted. client_nonce: Optional. 32-char hex idempotency token. reduce_only: HL only. Order may only close existing position size. …

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). Use this OR absolute price. trailing_stop_distance: RELATIVE DISTANCE for trailing stop (e.g. 0.0020). guaranteed_stop_loss: True to use GSLO (Premium, requires specific SL distance rule). slippage: Hyperliquid-only — fraction (0–0.5) capping IOC price band. Ignored by OANDA/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_distance: New RELATIVE distance (e.g. 0.0050). stop_loss_distance: New RELATIVE distance (e.g. 0.0020).

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. "2023-12-31T23:59:00Z"). Defaults to GTC if omitted. take_profit: ABSOLUTE PRICE. stop_loss: ABSOLUTE PRICE. take_profit_distance: RELATIVE DISTANCE (e.g. 0.0050). stop_loss_distance: RELATIVE DISTANCE (e.g. 0.0020). trailing_stop_distance:…

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 whichever wallet they have. No auth — every value is broadcast on-chain at payment time anyway.

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 mount so the build doesn't need its own VITE_SOLANA_* env vars; one source of truth lives on the MCP container.