Εργαλεία / Tools
Every tool AGORA serves, generated from the capability catalogue: the same source as tools/list and list_capabilities. Status: live = real City data now; sim = a sandbox stands in for a City system; pilot = a real API needs access, a sandbox is used.
Public server: https://agorathens.gr/mcp — anonymous, read-only
explain_rule— Explain a rule with a citation, or "no grounded answer" / Εξήγηση κανόνα με παραπομπή ή «καμία τεκμηριωμένη απάντηση» · sim · sources: curated, livefind_appointment_slots— Appointments with the City: procedures and free slots (AthensGov) / Ραντεβού με τον Δήμο: διαδικασίες και ελεύθερες ώρες (AthensGov) · pilot · sources: pilotfind_city_events— Events in the city / Εκδηλώσεις στην πόλη · pilot · sources: pilotfind_city_places— City places: KEP offices, libraries, parks, chargers and more / Σημεία του Δήμου: ΚΕΠ, βιβλιοθήκες, πάρκα, φορτιστές και άλλα · pilot · sources: pilotfind_city_projects— The City's projects / Έργα του Δήμου · pilot · sources: pilotfind_spaces— Find municipal spaces / Εύρεση δημοτικών χώρων · sim · sources: live, simget_accessibility_obstructions— Accessibility obstructions recorded by citizens / Εμπόδια προσβασιμότητας που κατέγραψαν πολίτες · live · sources: liveget_air_quality— Air quality near a point / Ποιότητα αέρα κοντά σε ένα σημείο · live · sources: curated, liveget_city_events— Public city events / Δημόσια γεγονότα της πόλης · sim · sources: live, simget_city_service— A City service (AthensGov registry): documents, cost, where and how / Υπηρεσία του Δήμου (μητρώο AthensGov): δικαιολογητικά, κόστος, πού και πώς · pilot · sources: pilotget_conditions— Weather, air quality, pollen, warnings and earthquakes / Καιρός, ποιότητα αέρα, γύρη, προειδοποιήσεις και σεισμοί · live · sources: liveget_council_subjects— Council subjects / Θέματα δημοτικού συμβουλίου · live · sources: liveget_decisions— Municipality of Athens decisions and spending (Diavgeia) / Αποφάσεις και δαπάνες του Δήμου Αθηναίων (Διαύγεια) · live · sources: liveget_footfall— Footfall (WiFi stations) / Επισκεψιμότητα (σημεία WiFi) · live · sources: liveget_map_layer— The City's map layers / Χαρτογραφικά επίπεδα του Δήμου · live · sources: liveget_mountain_refuges— Mountain refuges of Greece / Ορειβατικά καταφύγια της Ελλάδας · live · sources: liveget_neighbourhood— Neighbourhood and district for a point / Γειτονιά και δημοτική κοινότητα για ένα σημείο · live · sources: liveget_procedure— Administrative procedure (Mitos) — steps, documents, cost, duration / Διοικητική διαδικασία (Μίτος): βήματα, δικαιολογητικά, κόστος, διάρκεια · live · sources: livelist_capabilities— What the City's agent tools can do / Τι μπορεί να κάνει ο ψηφιακός Δήμος · live · sources: live, simlocate— Locate / Εντοπισμός · live · sources: livereachable— Reachable within / Πού φτάνω σε λίγα λεπτά · live · sources: liveroute— Route / Διαδρομή · live · sources: livesearch_city— Search the city / Αναζήτηση στην πόλη · live · sources: livesearch_city_web— Search the City's website / Αναζήτηση στον ιστότοπο του Δήμου · pilot · sources: pilot
Personal server: https://agorathens.gr/personal/mcp — the person's login (OAuth) and a mandate with the tool's scope
explain_rule— Explain a rule with a citation, or "no grounded answer" / Εξήγηση κανόνα με παραπομπή ή «καμία τεκμηριωμένη απάντηση» · sim · sources: curated, livefind_spaces— Find municipal spaces / Εύρεση δημοτικών χώρων · sim · sources: live, simget_city_events— Public city events / Δημόσια γεγονότα της πόλης · sim · sources: live, simlist_capabilities— What the City's agent tools can do / Τι μπορεί να κάνει ο ψηφιακός Δήμος · live · sources: live, simbook_appointment— Book an appointment with a City office / Ραντεβού με υπηρεσία του Δήμου · pilot · sources: pilot · scopes: appointments:bookcancel_appointment— Cancel an appointment with a City office / Ακύρωση ραντεβού με υπηρεσία του Δήμου · pilot · sources: pilot · scopes: appointments:bookcancel_booking— Cancel a booking / Ακύρωση κράτησης · sim · sources: sim · scopes: spaces:cancelcommit_booking— Commit a booking / Επιβεβαίωση κράτησης · sim · sources: sim · scopes: spaces:commitget_request_status— Status of my reports / Πορεία των αναφορών μου · sim · sources: sim · scopes: requests:readget_task_brief— Where we are / Πού βρισκόμαστε · sim · sources: sim · scopes: bookings:readlist_my_applications— My applications to the City / Οι αιτήσεις μου στον Δήμο · pilot · sources: pilot · scopes: applications:readlist_my_appointments— My appointments with City offices / Τα ραντεβού μου με υπηρεσίες του Δήμου · pilot · sources: pilot · scopes: appointments:readlist_my_bookings— My bookings / Οι κρατήσεις μου · sim · sources: sim · scopes: bookings:readlist_my_fines— My fines / Οι κλήσεις μου · pilot · sources: pilot · scopes: fines:readpay_fine— Pay a fine (approved on the City's page) / Πληρωμή κλήσης (εγκρίνεται στη σελίδα του Δήμου) · pilot · sources: pilot · scopes: fines:payprepare_booking— Prepare a booking / Προετοιμασία κράτησης · sim · sources: sim · scopes: spaces:preparerecover_booking— Recover a disrupted booking / Αποκατάσταση κράτησης · sim · sources: sim · scopes: spaces:commitreport_issue— Report a problem in the city / Αναφορά προβλήματος στην πόλη · sim · sources: live, sim · scopes: requests:filerequest_space— Request a space in an allocation round / Αίτημα σε γύρο κατανομής · sim · sources: live, sim · scopes: spaces:preparewithdraw_request— Withdraw a report / Απόσυρση αναφοράς · sim · sources: sim · scopes: requests:file
Staff server: https://agorathens.gr/staff/mcp — a named staff token
create_spell— Draft a staff rule / Πρόχειρος κανόνας προσωπικού · sim · sources: sim · scopes: staff:rulesreplay_event— Preview a rule over past rounds / Προεπισκόπηση κανόνα σε παλαιότερους γύρους · sim · sources: sim · scopes: staff:rules
Designed, not built
get_transit— designed, not built: Lines, stops and schedules; arrivals and positions when the live feed is upget_archive— designed, not built: Archive items for a place or topic, with rights notespost_task— designed, not built: Sends a task to a municipal teamactivate_policy— a human act on https://agorathens.gr/staff/spells, never an agent tool: Activates a reviewed rule (a spell); it becomes a skill
The City's own open data
The City of Athens publishes its datasets itself: the DCAT-AP catalogue of every dataset on opendata.cityofathens.gr, its API docs for the CKAN DataStore API data service, and its guides. AGORA's live reads come from that portal.
The tool list is signed
The City publishes and signs its tool list so anyone can check it: https://agorathens.gr/.well-known/agora-tools.json, keys at https://agorathens.gr/.well-known/agora-keys.json. Each server's tools are hashed exactly as tools/list serves them (SHA-256 of the canonical JSON: sorted keys, no whitespace, UTF-8). A tool whose digest does not match the signed list was changed on the way.
Call a public read over HTTP
curl -s 'https://agorathens.gr/v1/get_neighbourhood?lat=37.9838&lon=23.7275'
Every public read is also GET /v1/{tool}, described in OpenAPI. The personal tools are MCP only.
MCP revisions
The servers answer these MCP revisions, newest first: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26, 2024-11-05. 2026-07-28 use the stateless per-request envelope; the others, the initialize handshake. The list is the MCP SDK's own, from the version the server runs, and the server cards declare the same.
Call it over MCP
curl -s https://agorathens.gr/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2026-07-28' \
-H 'Mcp-Method: tools/list' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientInfo":{"name":"curl","version":"1"},"io.modelcontextprotocol/clientCapabilities":{}}}}'
Or add the server to an MCP client:
{
"mcpServers": {
"agora-athens": {
"type": "http",
"url": "https://agorathens.gr/mcp"
}
}
}