{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "version": "1.0.0",
  "name": "Balkan One Agentic Specification",
  "description": "Machine-readable agent capability definition, MCP tools, and conversion endpoints for Balkan One Think Tank.",
  "provider": {
    "name": "Balkan One Strategic Research Center",
    "url": "https://balkan.one",
    "contact": "info@balkanone.org",
    "license": "All Rights Reserved - Non-Partisan Think Tank"
  },
  "compliance": {
    "ar_prov": "compliant",
    "ax_audit_ready": true,
    "rate_limiting": {
      "limit": 120,
      "window_seconds": 60,
      "headers": ["RateLimit-Limit", "RateLimit-Remaining", "RateLimit-Reset"]
    }
  },
  "endpoints": {
    "base_url": "https://balkan.one",
    "llms_manifest": "https://balkan.one/llms.txt",
    "sitemap": "https://balkan.one/sitemap.xml",
    "problem_details": "https://balkan.one/404.html"
  },
  "mcp_tools": [
    {
      "name": "search_reports",
      "description": "Searches geopolitical strategic reports and analyses across 12 Balkan nations by keyword, country, or category.",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "description": "Keywords or search term (e.g., 'energy', 'Kosovo', 'TANAP', 'corridor')"
          },
          "country": {
            "type": "string",
            "enum": ["albania", "bosnia", "bulgaria", "croatia", "greece", "kosovo", "north-macedonia", "montenegro", "romania", "serbia", "slovenia", "turkey", "all"],
            "description": "Target country desk"
          }
        },
        "required": ["query"]
      },
      "target_url": "https://balkan.one/research?q={query}"
    },
    {
      "name": "get_country_briefing",
      "description": "Retrieves the strategic profile, active regional dossier, and key defense/energy indicators for any Balkan nation.",
      "parameters": {
        "type": "object",
        "properties": {
          "country": {
            "type": "string",
            "enum": ["albania", "bosnia", "bulgaria", "croatia", "greece", "kosovo", "north-macedonia", "montenegro", "romania", "serbia", "slovenia", "turkey"],
            "description": "Target Balkan country"
          }
        },
        "required": ["country"]
      },
      "target_url": "https://balkan.one/country/{country}"
    },
    {
      "name": "subscribe_dispatch",
      "description": "Registers an email for Balkan One's weekly strategic dispatches and geopolitical briefing alerts.",
      "parameters": {
        "type": "object",
        "properties": {
          "email": {
            "type": "string",
            "format": "email",
            "description": "Subscriber email address"
          }
        },
        "required": ["email"]
      },
      "target_url": "https://balkan.one/subscribe"
    },
    {
      "name": "request_expert_briefing",
      "description": "Submits an institutional inquiry or media request for analyst interviews and custom briefings.",
      "parameters": {
        "type": "object",
        "properties": {
          "organization": { "type": "string" },
          "contact_email": { "type": "string", "format": "email" },
          "topic": { "type": "string" }
        },
        "required": ["organization", "contact_email", "topic"]
      },
      "target_url": "https://balkan.one/about#contact"
    }
  ]
}