{"name":"ungovr-mcp","version":"1.0.0","protocol":"MCP","protocolVersion":"2025-03-26","tools":[{"name":"list_countries","description":"List all countries with government entity data in UnGovr, including entity counts and coverage metadata."},{"name":"search_entities","description":"Search government entities by country, optional state/province, name query, and entity type. Searches every tier of government in the jurisdiction, not just the top one: counties, cities, school districts, special districts, fire and police districts, joint powers authorities and regulated utilities are all reachable. Returns matching entities with slugs, types, and website URLs, plus a \"scope\" field — \"full\" means every tier was searched, \"direct_children\" means only the top tier was (narrow by state and search again). Unrecognised arguments are rejected, not ignored."},{"name":"get_entity","description":"Get full details for a specific government entity by its URL slug (e.g., \"us/ca/ventura\"). Works at any depth of the hierarchy, including cities, school districts and special districts (e.g., \"us/ca/santa-barbara/spd/carpinteria-valley\"). Returns name, type, website, parent, children, domain status, and metadata."},{"name":"get_product_coverage","description":"Get the full hierarchy of government entities where an UnGovr product is available. product=\"request\" returns the worldwide UnGovr Request coverage footprint (where you can file a government service request); product=\"cgj\" returns Civil Grand Jury coverage. Public, no API key required."},{"name":"get_open_records_law","description":"Get the open records law (FOIA/RTI equivalent) governing a jurisdiction: name, citation, response deadlines, fees, exemptions, appeal process, records retention rules and RTI rating. Accepts a jurisdiction slug (\"us/ca\", \"ie\", \"in/mh\") or any UnGovr entity slug at any depth (\"us/ca/santa-barbara/city/carpinteria\" resolves to the California law). US federal FOIA is jurisdiction \"us\". When the answer comes from a parent jurisdiction the response includes \"resolved_from\"."},{"name":"search_transparency_laws","description":"Search government transparency laws across five domains: open records, open meetings, fiscal transparency, digital accessibility, and oversight bodies. Filter by country, pillar, and/or a substring of the law name, citation, or jurisdiction. Returns compact records with jurisdiction slugs; use get_open_records_law for full open-records detail."},{"name":"search_cgj_reports","description":"Search California Grand Jury reports by county, year, and/or title keyword. Returns report metadata (title, year, county, themes). Requires X-API-Key header (50 req/day). Get a key at https://www.ungovr.org/open-data/api-keys. For the list of valid county names, query the UnGovr entity API: GET https://data.ungovr.org/v1/entities/us/ca.json"},{"name":"get_cgj_report","description":"Get full details for a specific California Grand Jury report by ID. Includes findings, recommendations, and responses. Requires X-API-Key header (50 req/day shared with data.ungovr.org). Get a key at https://www.ungovr.org/open-data/api-keys."},{"name":"list_service_types","description":"List available service request categories and types for a country. Returns service types grouped by category (e.g., Infrastructure, Utilities, Parks). Use this to discover valid service_type_id values for submit_service_request. Supported countries: US, IE (Ireland), GB (United Kingdom)."},{"name":"submit_service_request","description":"Submit a government service request (e.g., report a pothole, broken streetlight, illegal dumping). The request is validated, geocoded, classified, routed to the correct government entity, and recorded. Delivery is enabled per-entity: where the target channel is live, the request is transmitted (response delivery.state = \"sent\", or \"held\" when queued for review); for entities not yet enabled it is recorded and routable but not transmitted (delivery.state = \"dry_run\", or \"handoff\" with a redirect_url the user finishes). Always check delivery.state. Requires X-API-Key header. Rate limit: 2 requests/hour. Supported countries: US, IE (Ireland), GB (United Kingdom)."},{"name":"resolve_domain_jurisdiction","description":"Best-effort mapping from a domain to the jurisdiction whose law governs its OPERATOR. Authoritative for government domains in the UnGovr corpus (method \"entity_domains\"); otherwise an inference from suffix or country-code TLD, or \"unknown\". Never uses server or edge-node location: a CDN PoP's geography is not the legal signal, the operator's establishment is. IP addresses are refused for the same reason. Requires X-API-Key header (50 req/day, shared with data.ungovr.org). Get a key at https://www.ungovr.org/open-data/api-keys."}]}