civic-awareness-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Log level: debug, info, warn, error (default info) | info |
| API_DATA_GOV_KEY | No | api.data.gov key for Congress.gov and OpenFEC (required for federal server) | |
| OPENSTATES_API_KEY | No | OpenStates v3 API key (required for state server) | |
| CIVIC_STATE_DB_PATH | No | SQLite path for state server (default ./data/state.db) | ./data/state.db |
| CIVIC_FEDERAL_DB_PATH | No | SQLite path for federal server (default ./data/federal.db) | ./data/federal.db |
| CIVIC_AWARENESS_DAILY_BUDGET | No | Optional daily API spend cap |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| recent_billsA | List U.S. state legislative bills from OpenStates. Defaults to the last |
| get_billA | Fetch full detail for a single state bill including actions, versions, sponsors, and subjects. Requires jurisdiction, session, and identifier. |
| search_civic_documentsA | Search state civic documents (bills) by title. Optionally filter by jurisdiction, kind, source, or date range. |
| search_entitiesA | Search for people or organizations by name across state legislatures (OpenStates). Pass a jurisdiction to trigger upstream hydration. |
| resolve_personB | Disambiguate a person by name across state legislators. Returns all matching Person entities with confidence tiers. Supply jurisdiction_hint to trigger upstream OpenStates hydration. |
| get_entityA | Fetch a single entity by ID with recent related documents. For state Persons, returns the cross-jurisdiction roles[] history. |
| entity_connectionsA | Given an entity ID, return co-occurrence edges to other entities via shared state bills. Supports depth=1 (direct) or depth=2 (through one hop). Edges are capped at 100 and sorted by co_occurrence_count descending. |
| recent_votesA | List recent roll-call votes from state legislatures via OpenStates. Pass a jurisdiction like 'us-tx' or 'us-ca'. Votes are sourced from recently-updated bills with embedded vote data. Use '*' to query all cached jurisdictions locally. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Most tools have distinct purposes (bill detail, entity lookup, recent bills, votes, search, connections). However, search_civic_documents and recent_bills both retrieve bills, though via different access patterns (search vs. listing), causing minor overlap.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., get_bill, search_entities, recent_votes). No naming style conflicts.
8 tools cover the domain of state legislative data without being too few or excessive. Each tool serves a clear function in the workflow.
Core operations for browsing state bills, entities, votes, and connections are present. Missing features like jurisdiction listing or bill text retrieval are minor gaps that don't break typical workflows.