Skip to main content
Glama
ForexNewsRadar MCP Server

ForexNewsRadar MCP Server

Official

Overview

ForexNewsRadar provides real-time 18-pair FX & Metals (XAUUSD, XAGUSD) macro surprise telemetry (surprise_z), strict prop-firm T-5m pre-news and 5-minute post-release blackouts (FTMO, FundingPips, The5ers), and post-release VETO shields (two-way whipsaw, foreign-print collisions, and central bank press-conference toxicity).

This open-source repository ships the official client tooling, MQL5 integration files, local zero-dependency Stdio-to-HTTP bridge, and registry manifests. The production Streamable HTTP MCP server runs on Cloudflare Edge at https://forexnewsradar.com/mcp.


Related MCP server: tradingprogpt

System Architecture

One real-time risk engine serves human desks, MetaTrader 5 bots (including closed-source .ex5 EAs), and AI coding/trading agents without duplicating calendar scraping or broker clock offsets:

flowchart LR
  Edge["ForexNewsRadar Cloudflare Edge\n18 FX & Metals · Quant Surprise (σ) + 4-Guard VETO"]

  Edge -->|"Streamable HTTP MCP\nPOST /mcp (2026-07-28)"| Agents["AI Agents & Native Clients\nClaude Code · Cursor · Codex · Grok · MT5 MCP"]
  Edge -->|"Zero-Dep Stdio Bridge\nbridge/fnr-mcp-bridge.mjs"| Stdio["Stdio-Only Hosts\nClaude Desktop · Windsurf · Cline · Antigravity"]
  Edge -->|"Compact JSON (4 req/min)\nGET /api/v1/pairs?compact=1"| Hub["MT5 Master Hub EA\nmt5/ForexNewsRadar_PropShield.mq5"]

  Hub -->|"GlobalVariableTemp()\n~0.001ms Volatile RAM Bus"| EAs["Custom .mq5 EAs\nmt5/ForexNewsRadar.mqh"]
  Hub -->|"OnTradeTransaction()\n8/min Hyperactivity Cap"| Ex5["Compiled .ex5 Bots\nPending-Order Sweep Only"]

Repository Contents

.
├── package.json                        # Zero-dependency Node.js >=18.17 package & npx CLI bin
├── server.json                         # Official MCP Registry manifest (com.forexnewsradar/mcp)
├── glama.json                          # Glama MCP directory ownership manifest
├── SECURITY.md                         # Security policy, read-only guarantees & disclosure contact
├── bridge/
│   └── fnr-mcp-bridge.mjs              # Zero-dependency Node.js Stdio -> Streamable HTTP bridge
├── mt5/
│   ├── ForexNewsRadar_PropShield.mq5   # Zero-DLL single-chart MT5 Master Hub EA + HUD + RAM bus
│   └── ForexNewsRadar.mqh              # Drop-in MQL5 header (RAM bus reader + 18-slot WebRequest fallback)
├── docs/
│   └── assets/                         # Terminal, MCP & MT5 visual references
├── .gitignore
└── LICENSE                             # MIT License

1. Remote Streamable HTTP MCP Server (com.forexnewsradar/mcp)

Property

Value

Official Registry ID

com.forexnewsradar/mcp

Production Endpoint

https://forexnewsradar.com/mcp

Protocol Compatibility

2026-07-28 (SEP-2575 server/discover + SEP-2549 caching), 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05

Discovery Metadata

/.well-known/mcp.json (RFC 8615)  •  /.well-known/oauth-protected-resource (RFC 9728)

Authentication

Authorization: Bearer <FNR_API_KEY> (fixed-term pass from forexnewsradar.com, zero auto-renewal; EURUSD REST & discovery endpoints require no key)

Claude Code (1-Line CLI)

export FNR_API_KEY="fnr_live_your_token_here"
claude mcp add --transport http forexnewsradar https://forexnewsradar.com/mcp \
  --header "Authorization: Bearer $FNR_API_KEY"

Cursor / Standard .mcp.json

{
  "mcpServers": {
    "forexnewsradar": {
      "type": "http",
      "url": "https://forexnewsradar.com/mcp",
      "headers": {
        "Authorization": "Bearer ${FNR_API_KEY}"
      }
    }
  }
}

Native MetaTrader 5 MCP Client

In current MetaTrader 5 builds with native MCP client support:

  1. Open Tools -> Options -> MCP.

  2. Click + Add new MCP server.

  3. Set Endpoint to https://forexnewsradar.com/mcp and paste your FNR_API_KEY into API key.

Stdio-Only Hosts (Claude Desktop, Windsurf, Cline, Antigravity)

Run the zero-dependency Node.js (>=18.17.0) bridge directly via npx, or clone this repository and point to bridge/fnr-mcp-bridge.mjs:

{
  "mcpServers": {
    "forexnewsradar": {
      "command": "npx",
      "args": ["-y", "github:ForexNewsRadar/forexnewsradar-mcp"],
      "env": {
        "FNR_API_KEY": "fnr_live_your_token_here"
      }
    }
  }
}

When cloning locally, you can avoid putting tokens inside IDE config files altogether by saving FNR_API_KEY=fnr_live_... inside a gitignored .env file in the repository root (bridge/fnr-mcp-bridge.mjs reads it automatically).

Five Strictly Read-Only MCP Tools

All five tools enforce an Object.hasOwn parameter allowlist (failing closed on unknown arguments) and normalize spoken aliases (GOLD -> XAUUSD, SILVER -> XAGUSD) plus broker suffixes (EURUSD.pro, XAUUSDm, mEURUSD) server-side:

Tool

Purpose & Returned Fields

check_prop_trade_gate

Instant pre-trade gate returning prop_safe_to_trade, T-5m pre/post blackout state, VETO reason, directional bias (BUY / SELL / NEUTRAL), wait_seconds, and surprise_z

get_pair_telemetry

Full instrument telemetry: live_state, agent_guidance, next Tier-1 catalyst countdown, recent macro prints (Actual vs. Forecast, surprise_z), and closed ECN fills

list_radar_pairs

Multi-pair snapshot across Tokyo, London, and New York sessions (all, unlocked, active_signals, Metals, USD, EUR, JPY, GBP)

get_macro_feed

Unified stream of upcoming Red-Folder catalysts, active PRE_NEWS / VETO locks, and recent macro prints

get_entitlement_status

Introspects unlocked pair scopes, key expiry timestamp, and per-minute quota (240 req/min)


2. Zero-DLL MetaTrader 5 PropShield EA & MQL5 SDK

mt5/ForexNewsRadar_PropShield.mq5 eliminates the silent empty CalendarValueHistory() / MqlCalendarValue fail-open bug on white-label prop-firm servers with zero DLLs:

  1. Attach ForexNewsRadar_PropShield.mq5 to one chart (for example EURUSD).

  2. Whitelist https://forexnewsradar.com in Tools -> Options -> Expert Advisors -> Allow WebRequest for listed URL.

  3. Every 15 seconds (4 req/min), the Hub EA fetches GET /api/v1/pairs?compact=1, draws lightweight OBJ_LABEL status badges across all open charts, and updates volatile RAM globals via GlobalVariableTemp():

Volatile RAM Global

Semantics

FNR_HEARTBEAT_TS

UTC epoch timestamp of the last valid sync (fail-closed if missing or older than 45s)

FNR_PROP_SAFE_<SYM>

1.0 when clear to trade; 0.0 during T-5m PRE_NEWS, 5-minute post-release window, VETO, stale feed, or locked pair

FNR_WAIT_SEC_<SYM>

Exact countdown in seconds until the restricted news window clears

FNR_BIAS_<SYM>

1.0 (BUY), -1.0 (SELL), or 0.0 (NEUTRAL)

FNR_UNLOCKED_<SYM>

1.0 if the pair is unlocked on the active key

For compiled third-party .ex5 bots without source code, optional pending-order protection (InpDeletePendingOnVeto = true, false by default) intercepts resting and newly submitted pending orders via OnTradeTransaction(TRADE_TRANSACTION_ORDER_ADD) during active PRE_NEWS / VETO windows, never touches open market positions, and enforces an InpMaxDeletesPerMin = 8 circuit breaker against prop-firm Server Hyperactivity bans.

Drop-In MQL5 Check (mt5/ForexNewsRadar.mqh)

Copy mt5/ForexNewsRadar.mqh into MQL5/Include/:

#include <ForexNewsRadar.mqh> // Place ForexNewsRadar.mqh inside MQL5/Include/

input string InpFnrApiKey = ""; // Optional when PropShield Hub EA runs on EURUSD, or for free EURUSD

void OnTick() {
   // Returns true inside Strategy Tester (MQL_TESTER),
   // reads PropShield RAM globals in ~0.001ms when fresh (<= 45s),
   // or falls back to a cached 18-slot WebRequest().
   if(!FNR_IsPropSafe(_Symbol, InpFnrApiKey)) {
      return;
   }
   // Continue normal entry logic
}

3. Test the Live Wire Without an API Key

EURUSD telemetry and MCP discovery metadata are open with no API key required:

# RFC 8615 MCP Server Card (2026-07-28 capabilities & tool schemas)
curl -sS https://forexnewsradar.com/.well-known/mcp.json

# Full EUR/USD live telemetry (radar_health, agent_guidance, recent sigma releases)
curl -sS https://forexnewsradar.com/api/v1/pairs/EURUSD

# ~250-byte flat JSON payload tailored for MQL5 WebRequest() char[] buffers
curl -sS "https://forexnewsradar.com/api/v1/pairs/EURUSD?compact=1"

4. Security & Read-Only Guarantees

See SECURITY.md for the full disclosure policy:

  • 100% Read-Only MCP: None of the 5 MCP tools can place, modify, or close trades, or access broker accounts.

  • Fail-Closed Validation: Unknown tool arguments (Object.hasOwn allowlist), stale heartbeats, and HTTP 402/5xx errors default to prop_safe_to_trade: false.

  • Hardened Stdio Bridge: bridge/fnr-mcp-bridge.mjs uses zero npm dependencies, pins HTTPS requests strictly to forexnewsradar.com, enforces redirect: 'error' (preventing cross-origin Bearer leaks), and redacts fnr_live_ tokens in error output.

  • Zero-DLL MQL5: Both .mq5 and .mqh files compile cleanly in MetaEditor using only native WebRequest() and GlobalVariableTemp().


5. Official Platform Resources & Engineering Guides

Core Product & Machine-Readable Specs

Engineering Playbooks (/solutions) & Video Academy (/guides)

Flagship Live Pair Pages & Community

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Read-only MCP server that lets a verified client connect their own AI to their trading account to read account data without order execution.
      -
    • F
      license
      Not graded
      quality
      C
      maintenance
      Read-only MCP server exposing MetaTrader 5 account and market data alongside Twelve Data quotes and technical indicators, with an LLM analysis layer.
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides read-only MCP tools for market snapshots, position risk, order reconciliation, and daily report previews with deterministic financial calculations, evidence chains, and audit trails.
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables MCP clients to read MetaTrader 4 and 5 account data, including balances, open positions, closed trades, quotes, symbol specifications, and price history, without placing, modifying, or closing orders.
      MIT