ForexNewsRadar MCP Server
OfficialThis server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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 License1. Remote Streamable HTTP MCP Server (com.forexnewsradar/mcp)
Property | Value |
Official Registry ID | |
Production Endpoint |
|
Protocol Compatibility |
|
Discovery Metadata |
|
Authentication |
|
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:
Open
Tools -> Options -> MCP.Click
+ Add new MCP server.Set Endpoint to
https://forexnewsradar.com/mcpand paste yourFNR_API_KEYinto 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 |
| Instant pre-trade gate returning |
| Full instrument telemetry: |
| Multi-pair snapshot across Tokyo, London, and New York sessions ( |
| Unified stream of upcoming Red-Folder catalysts, active |
| Introspects unlocked pair scopes, key expiry timestamp, and per-minute quota ( |
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:
Attach
ForexNewsRadar_PropShield.mq5to one chart (for exampleEURUSD).Whitelist
https://forexnewsradar.cominTools -> Options -> Expert Advisors -> Allow WebRequest for listed URL.Every 15 seconds (
4 req/min), the Hub EA fetchesGET /api/v1/pairs?compact=1, draws lightweightOBJ_LABELstatus badges across all open charts, and updates volatile RAM globals viaGlobalVariableTemp():
Volatile RAM Global | Semantics |
| UTC epoch timestamp of the last valid sync (fail-closed if missing or older than |
|
|
| Exact countdown in seconds until the restricted news window clears |
|
|
|
|
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.hasOwnallowlist), stale heartbeats, and HTTP 402/5xx errors default toprop_safe_to_trade: false.Hardened Stdio Bridge:
bridge/fnr-mcp-bridge.mjsuses zero npm dependencies, pins HTTPS requests strictly toforexnewsradar.com, enforcesredirect: 'error'(preventing cross-origin Bearer leaks), and redactsfnr_live_tokens in error output.Zero-DLL MQL5: Both
.mq5and.mqhfiles compile cleanly in MetaEditor using only nativeWebRequest()andGlobalVariableTemp().
5. Official Platform Resources & Engineering Guides
Core Product & Machine-Readable Specs
Live 18-Pair Terminal (
EUR/USDFree Forever): https://forexnewsradar.comMCP Integration Portal & Quickstart: https://forexnewsradar.com/?mcp=1
Official MCP Registry Listing: https://registry.modelcontextprotocol.io/?q=com.forexnewsradar
OpenAPI 3.1 Specification: https://forexnewsradar.com/openapi.json
Agent Docs (
/llms.txt&/llms-full.txt): https://forexnewsradar.com/llms.txt • https://forexnewsradar.com/llms-full.txtPartner & Affiliate Portal (
35%–50%): https://forexnewsradar.com/partners
Engineering Playbooks (/solutions) & Video Academy (/guides)
Prop-Firm News Rule MT5 EA Guide: FTMO, FundingPips & The5ers
T-5mcomplianceFix Disabled
MqlCalendarValueon Prop Servers: Handling silent empty arrays & DST driftDelete Pending Orders Before News on
.ex5Bots: Event-driven sweeps with Hyperactivity GuardForex & Gold Macro News MCP Server Guide: Connecting Claude Code, Cursor, Codex, Grok & native MT5
Quant Video Academy (
/guides) • YouTube@ForexNewsRadar
Flagship Live Pair Pages & Community
Live Instrument Telemetry: EUR/USD • XAU/USD (Gold) • XAG/USD (Silver) • GBP/USD • USD/JPY • GBP/JPY
Engineering Deep Dive (Dev.to): Why MT5
CalendarValueHistory()Fails Prop-Firm News RulesCommunity & Updates: X
@ForexNewsRadarX • Redditr/ForexNewsRadar • MQL5 Profile
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Read-only access to your MetaTrader 4 and 5 accounts for AI agents: balances, open positions, trade history with win rate, live quotes, symbol specs and candles. It cannot place, modify or close orders.
Read-only MetaTrader 5 for AI agents: balances, positions, history and prices. Sign in with OAuth.
One MCP and REST API giving AI agents sourced figures on economics, markets, companies and calendars
Read-only MCP access to DSGHT.ai published foresight and country-grounded claim resolution.
Related MCP Servers
FlicenseNot gradedqualityDmaintenanceRead-only MCP server that lets a verified client connect their own AI to their trading account to read account data without order execution.-- FlicenseNot gradedqualityCmaintenanceRead-only MCP server exposing MetaTrader 5 account and market data alongside Twelve Data quotes and technical indicators, with an LLM analysis layer.-
- AlicenseNot gradedqualityCmaintenanceProvides 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

FxSocket MCPofficial
AlicenseNot gradedqualityBmaintenanceEnables 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