Futuristic Risk Intelligence

Instructions

Implementation Reference

• mcp_server/server.py:159-171 (handler)

  The handle_get_conflict_risks function retrieves and filters conflict data from conflicts.json.

  def handle_get_conflict_risks(args: dict) -> str:
      data = _load_json("conflicts.json")
      if "error" in data:
          return json.dumps(data)
  
      conflict_id = args.get("conflict_id")
      if conflict_id:
          filtered = [c for c in data.get("conflicts", []) if c["conflict_id"] == conflict_id]
          if not filtered:
              return json.dumps({"error": f"Conflict '{conflict_id}' not found"})
          data["conflicts"] = filtered
  
      return json.dumps(data, indent=2)

• mcp_server/server.py:81-110 (schema)

  The MCP tool registration and schema definition for 'get_conflict_risks'.

  {
      "name": "get_conflict_risks",
      "description": (
          "Get current geopolitical conflict risk probabilities for 6 major regions: "
          "Russia-Ukraine, Iran-Israel/US, Israel-Palestine, China-Taiwan, India-Pakistan, US-Latin America. "
          "Each conflict includes probability of escalation, ceasefire, regime change, and other events "
          "within 1-day, 7-day, and 30-day horizons. "
          "Probabilities are derived from proprietary multi-source modeling. "
          "Updated daily. Use this to assess geopolitical risk exposure for trading or risk management."
      ),
      "inputSchema": {
          "type": "object",
          "properties": {
              "conflict_id": {
                  "type": "string",
                  "description": (
                      "Optional: filter to a single conflict region. "
                      "Valid values: russia_ukraine, iran_israel_us, israel_palestine, "
                      "china_taiwan, india_pakistan, us_latam. "
                      "Omit to get all 6 regions."
                  ),
                  "enum": [
                      "russia_ukraine", "iran_israel_us", "israel_palestine",
                      "china_taiwan", "india_pakistan", "us_latam",
                  ],
              },
          },
          "required": [],
      },
  },

• mcp_server/server.py:198-199 (registration)

  Registration of the handle_get_conflict_risks handler within the TOOL_HANDLERS dictionary.

  TOOL_HANDLERS = {
      "get_conflict_risks": handle_get_conflict_risks,