# Balkan One Agent Instructions & Integration Guide

Welcome to **Balkan One** (`https://balkan.one`), the geopolitical intelligence think tank and OSINT analysis platform for the 12 Balkan nations.

## Integration Protocols
- **MCP Server Card:** `https://balkan.one/.well-known/mcp.json`
- **OpenAPI 3.1 Spec:** `https://balkan.one/openapi.json`
- **Summary LLMs Manifest:** `https://balkan.one/llms.txt`
- **Full Knowledge Base:** `https://balkan.one/llms-full.txt`
- **Syndicated Feed:** `https://balkan.one/feed.xml`

## Available Tools & Actions
1. **Search Intelligence:**
   Query `/research?q={terms}` for articles, policy analyses, and regional dossiers.
2. **Retrieve Country Profile:**
   Query `/country/{slug}` (slugs: `albania`, `bosnia`, `bulgaria`, `croatia`, `greece`, `kosovo`, `north-macedonia`, `montenegro`, `romania`, `serbia`, `slovenia`, `turkey`).
3. **Geopolitical Infrastructure:**
   Access `/maps/geopolitical.html` for geospatial coordinates of pipelines, LNG hubs, and defense bases.
4. **Subscribe to Briefings:**
   Send `POST /subscribe` with JSON `{"email": "subscriber@domain.com"}`.

## Rate Limits
Clients and automated agents are allocated 120 requests per minute with standard headers:
`RateLimit-Limit`, `RateLimit-Remaining`, and `RateLimit-Reset`.