# OpenPublica

> Search US local-government meetings: AI summaries, transcripts, and adopted plan documents.

- name: com.openpublica/civic-meetings
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 80/100 flags: no-repository
- quality: 69/100 (needs work)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.openpublica%2Fcivic-meetings
- tools: https://api.protogrid.dev/v1/servers/com.openpublica%2Fcivic-meetings/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "civic-meetings": {
      "type": "http",
      "url": "https://api.openpublica.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 100
- freshness: 85
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-100% ~updated-54d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 69/100 (needs work)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 86 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 16 of 16 tools declare readOnlyHint or destructiveHint
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_meeting_content (idempotentHint); find_governments_by_name (idempotentHint); find_governments_by_zip (idempotentHint); …
- pass `tools.token_cost`: about 4,335 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 25 (weight 15)

- warn `stability.changes`: 22 tool changes in 30 days
- fail `stability.rug_pull`: 3 tools kept their name but changed most of their description in 30 days; review before trusting them

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 16, about 4,335 tokens to load them all
- tool set hash: f25811b97e343af8c29ff872ae2e0834
- tools last changed: 2026-10-18T02:17:09.186Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.openpublica/civic-meetings.svg)](https://protogrid.dev/servers/com.openpublica/civic-meetings)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-18 `get_coverage_overview` changed (description, annotations) **meaning changed**
  - before: Get OpenPublica's overall coverage: total governments, states, and meetings indexed. DC is tracked but is not a state, so it is reported separately as `includes_dc` — read the pair as "N states and DC".
  - after: Get estimated stored-record totals, not publication-filtered coverage. Counts do not establish completeness, searchability or freshness. DC is reported separately from states as `includes_dc`.
- 2026-10-18 `search_documents` changed (annotations)
- 2026-10-18 `read_document_pages` changed (annotations)
- 2026-10-18 `get_document` changed (annotations)
- 2026-10-18 `list_government_documents` changed (annotations)
- 2026-10-18 `discover_meeting_vocabulary` changed (annotations)
- 2026-10-18 `get_government_stats` changed (annotations)
- 2026-10-18 `get_government_info` changed (annotations)
- 2026-10-18 `find_governments_by_zip` changed (annotations)
- 2026-10-18 `find_governments_by_name` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/com.openpublica%2Fcivic-meetings/changes

## Remotes

- https://api.openpublica.com/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (16)

- `discover_meeting_vocabulary`: Discover the valid category and topic filter values before filtering a search.

    Meeting `category_tag`s are opaque UUIDs and topics have no fixed list, so you
    cannot guess them. Call this first to get the real values, then pass a returned
    `category_tag` (from `categories[].tags`) or `topic` string into
    `search_meetings_semantic` / `list_recent_meetings`. Scope with a government
    and/or date range; calls without explicit dates default to a recent window
    (returned as `default_window_days`).
    
- `find_governments_by_name`: Resolve a place *name* to the governments OpenPublica tracks there.

    Use this when you know a city/state name but not its coordinates — it returns
    matching governments with their `account_id` (prefix matches first), which you
    then pass to the search/list tools. Prefer this over `find_local_governments`
    when starting from a name rather than a latitude/longitude.
    
- `find_governments_by_zip`: Resolve a ZIP code to nearby tracked governments.

    Convenience wrapper: geocodes the ZIP, then finds the governments OpenPublica
    tracks nearest that point. Returns their `account_id`s plus the resolved
    location. An empty `governments` list means none are tracked near that ZIP yet.
    
- `find_local_governments`: Discover which governments OpenPublica tracks near a coordinate.

    Returns nearby governments with their `account_id`, which you can pass to the
    other tools to scope results to a specific city or board. Note OpenPublica
    only covers a limited set of US localities; an empty result means none are
    tracked near that point yet.
    
- `get_coverage_overview`: Get estimated stored-record totals, not publication-filtered coverage.

    Counts do not establish completeness, searchability or freshness. DC is
    reported separately from states as `includes_dc`.
    
- `get_document`: One document's metadata. Use read_document_pages to read it.

    If an `availability` key is present, read it before quoting figures: its
    `problems` are transcription-lint findings, most often a footnote marker
    that may have been merged into the number it annotates. No such key means
    the document transcribed cleanly.
    
- `get_government_info`: Get a tracked government's profile: name, location, and meeting categories.
- `get_government_stats`: Get meeting-activity stats for a government over a recent window.

    Returns total meeting count, a per-day activity map, and a breakdown of
    meeting categories — useful for "how active has X been lately?" questions.
    
- `get_meeting`: Get a single meeting's full AI summary and topics.

    Set `include_transcript=true` to also retrieve the complete transcript text
    for direct quotation. Returns an error object if the meeting is not found.
    
- `list_government_documents`: List a government's adopted plan and budget documents.

    Each entry carries `covers` — every general-plan element that document
    answers for. A city that publishes one bound general plan satisfies all
    eight with the same PDF, so do not conclude an element is unpublished
    because no entry is named after it.

    `status` says what the entry offers: `converted` is searchable and readable;
    `superseded` is a retired edition, still stored but not searchable; and
    **`failed` means we hold this document and could not read it — it is not
    evidence the city published nothing.** Cite `source_url` in that case; it is
    always the city's own copy.

    An `availability` block appears ONLY when something is wrong with a
    document, and `availability.reason` says what. No `availability` key means
    there is nothing to report.
    
- `list_recent_meetings`: Browse meetings newest-first, optionally filtered by government, type, topic, or date.

    Use this for "what are the most recent meetings" or to page through a
    government's history. For topical questions, prefer `search_meetings_semantic`.
    
- `read_document_pages`: Read a page range of a document as markdown.

    Pages are transcribed from rendered pixels, so tables and scanned text come
    through as text. A page that could not be transcribed appears as a marked
    hole rather than being silently dropped — if you see one, say so instead of
    reading past it.

    Text is assembled from page windows, so `covered` may be slightly wider than
    what you asked for; cite the page numbers in `covered`, not `requested`.
    
- `search_documents`: Search adopted plan and budget documents, returning page-cited excerpts.

    Each hit's `text` is a short passage around the match, not the full page —
    call read_document_pages with the hit's `first_page` to read it in context.

    Every hit carries `first_page`/`last_page` and `source_url`. Quote those
    when citing: the page number is what makes the claim checkable against the
    city's own copy.

    This is word matching, not semantic search — try the terms a plan would
    actually use. Only currently-served documents are searchable, so an empty
    result is not evidence the government has no such policy; check
    list_government_documents for what is held and what could not be read.

    A hit with `document_complete: false` comes from a document with
    transcription findings. Verify it against `source_url` before quoting a
    number from it.
    
- `search_meeting_content`: Search public meetings once across metadata and stored transcript text.

    Returns one card per meeting and native pagination metadata, without a total.
    Small current-text previews can be absent and do not establish timestamps.
    Text relevance can lag updates or match across untimed boundaries.
    Source transcripts searches stored text, including meetings without timed proof.
    
- `search_meetings_semantic`: Find AI summaries by meaning; use search_meeting_content for stored words.

    Results carry relevance_score and a summary preview. Narrow with government,
    category_tag, topic or dates; get_meeting retrieves the full summary.
    
- `search_meeting_transcript`: Use unified stored-text search inside one currently public meeting.

    Returns an optional current-text preview, without resolving timing. A text match
    can lack a literal preview; use get_meeting(include_transcript=true) for full source
    retrieval. This does not run a separate local scan or fuzzy passage ranking.
    
