{
  "schema": "forexnewsradar.mcp_server_card.v2",
  "version": "2.0",
  "protocolVersions": [
    "2026-07-28",
    "2025-11-25",
    "2025-06-18",
    "2025-03-26",
    "2024-11-05"
  ],
  "serverInfo": {
    "name": "forexnewsradar",
    "title": "ForexNewsRadar — Live FX & Gold Macro Signals + Prop-Firm VETO MCP",
    "version": "4.6.5",
    "description": "Real-time Actual vs Forecast macro surprise (sigma) telemetry, T-5m pre-news & post-release Whipsaw VETO protection, and directional BUY/SELL verdicts across 18 FX, Gold (XAUUSD) & Silver (XAGUSD) pairs. Public web & REST demo for EUR/USD is free at /api/v1/pairs/EURUSD; connecting to POST /mcp requires an active FNR_API_KEY ($9/30d Single Pair or $29/30d All 18 Pairs).",
    "homepage": "https://forexnewsradar.com",
    "documentation": "https://forexnewsradar.com/llms.txt",
    "openapi": "https://forexnewsradar.com/openapi.json",
    "oauthProtectedResource": "https://forexnewsradar.com/.well-known/oauth-protected-resource"
  },
  "transport": {
    "type": "streamable-http",
    "stateless": true,
    "endpoint": "https://forexnewsradar.com/mcp"
  },
  "authentication": {
    "required": true,
    "scheme": "Bearer",
    "header": "Authorization: Bearer fnr_live_...",
    "protected_resource_metadata": "https://forexnewsradar.com/.well-known/oauth-protected-resource",
    "plans": "Single Pair ($9/30d) or All 18 Pairs + Gold & Silver ($29/30d) at 240 req/min (Apple Pay, Google Pay, Card, or Crypto via Whop MoR (fixed-term, zero auto-renewal)).",
    "free_rest_demo": "https://forexnewsradar.com/api/v1/pairs/EURUSD",
    "unlock_url": "https://forexnewsradar.com/?unlock=ALL"
  },
  "capabilities": {
    "tools": [
      {
        "name": "check_prop_trade_gate",
        "title": "Check Prop-Firm & Macro Trade Gate",
        "description": "Instant pre-trade safety check for any of the 18 FX, Gold (XAUUSD / GOLD) & Silver (XAGUSD / SILVER) pairs (broker suffixes like EURUSD.pro or XAUUSDm normalized automatically). Returns boolean prop_safe_to_trade (enforces T-5m PRE_NEWS blackout, 5m post-release Restricted News Window, and Whipsaw/Collision/Foreign Noise/Toxic Window VETO shields), directional bias (BUY | SELL | NEUTRAL), wait_seconds countdown, and standardized surprise_z. Requires active FNR_API_KEY."
      },
      {
        "name": "get_pair_telemetry",
        "title": "Get Full Quantitative Pair Telemetry",
        "description": "Full real-time macro telemetry for one FX or Metals instrument: live_state (CLEAR | PRE_NEWS | BUY | SELL | VETO), agent_guidance, next scheduled Tier-1 catalyst countdown, recent macro releases (Actual vs Forecast, standardized surprise_z in sigma, Quant Model notes, ACTIVE vs SETTLED lifecycle), and recent Live ECN Portfolio trades."
      },
      {
        "name": "list_radar_pairs",
        "title": "List 18-Pair Macro Radar Board",
        "description": "Snapshot of all 18 monitored FX Majors, JPY Crosses, Gold (XAUUSD), and Silver (XAGUSD) across Tokyo, London, and New York sessions. Returns live verdicts for all unlocked scopes on your FNR_API_KEY plus upcoming pre-news countdowns."
      },
      {
        "name": "get_macro_feed",
        "title": "Get Upcoming Catalysts & Active VETO Stream",
        "description": "Unified stream of upcoming Red-Folder macro events (scheduled_at, starts_in_sec, pre_veto_minutes), active VETO/PRE_NEWS locks, and recent macro prints scoped to your unlocked pairs. Supports optional currency or symbol filtering."
      },
      {
        "name": "get_entitlement_status",
        "title": "Inspect API Key & Rate-Limit Status",
        "description": "Introspects your active ForexNewsRadar FNR_API_KEY: unlocked pair scopes (Single Pair or All 18 Pairs), expiration timestamp, and per-minute rate-limit quota (240 req/min)."
      }
    ],
    "resources": [
      {
        "uri": "forexnewsradar://docs/llms",
        "name": "ForexNewsRadar Agent & API Integration Guide",
        "description": "Complete documentation for forexnewsradar.com endpoints, VETO states, MQL5 EA, Python, and MCP tools.",
        "mimeType": "text/markdown"
      },
      {
        "uri": "forexnewsradar://catalog/pairs",
        "name": "18 Monitored FX, Gold & Silver Instruments",
        "description": "Canonical 18-pair symbol list, currency legs, peak volatility sessions, and primary macro drivers.",
        "mimeType": "application/json"
      }
    ],
    "prompts": [
      {
        "name": "pre_trade_prop_check",
        "title": "Pre-Trade Prop-Firm News & VETO Check",
        "description": "Checks whether a pair is safe to enter right now under FTMO / FundingPips / The5ers T-5m news rules and explains active macro drivers.",
        "arguments": [
          {
            "name": "symbol",
            "description": "Pair symbol such as XAUUSD, EURUSD, GBPUSD, or USDJPY (defaults to EURUSD).",
            "required": false
          }
        ]
      },
      {
        "name": "session_macro_briefing",
        "title": "Cross-Session FX & Gold Macro Briefing",
        "description": "Summarizes active BUY/SELL impulses, VETO shields, and upcoming Red-Folder macro events for Tokyo, London, or New York.",
        "arguments": [
          {
            "name": "session",
            "description": "Target trading session: tokyo, london, or ny (optional).",
            "required": false
          }
        ]
      }
    ]
  },
  "quickstart": {
    "claude_code": "claude mcp add --transport http forexnewsradar https://forexnewsradar.com/mcp --header \"Authorization: Bearer ${FNR_API_KEY}\"",
    "cursor_and_claude_mcp_json": {
      "mcpServers": {
        "forexnewsradar": {
          "type": "http",
          "url": "https://forexnewsradar.com/mcp",
          "headers": {
            "Authorization": "Bearer ${FNR_API_KEY}"
          }
        }
      }
    },
    "vscode_mcp_json": {
      "inputs": [
        {
          "type": "promptString",
          "id": "fnr_api_key",
          "description": "ForexNewsRadar API Key (fnr_live_...)",
          "password": true
        }
      ],
      "servers": {
        "forexnewsradar": {
          "type": "http",
          "url": "https://forexnewsradar.com/mcp",
          "headers": {
            "Authorization": "Bearer ${input:fnr_api_key}"
          }
        }
      }
    },
    "xai_grok_connector": "https://forexnewsradar.com/mcp"
  }
}