Skip to main content
Glama
julianken

civic-awareness-mcp

by julianken

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LOG_LEVELNoLog level: debug, info, warn, error (default info)info
API_DATA_GOV_KEYNoapi.data.gov key for Congress.gov and OpenFEC (required for federal server)
OPENSTATES_API_KEYNoOpenStates v3 API key (required for state server)
CIVIC_STATE_DB_PATHNoSQLite path for state server (default ./data/state.db)./data/state.db
CIVIC_FEDERAL_DB_PATHNoSQLite path for federal server (default ./data/federal.db)./data/federal.db
CIVIC_AWARENESS_DAILY_BUDGETNoOptional daily API spend cap

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
recent_billsA

List U.S. state legislative bills from OpenStates. Defaults to the last days (default 7) of recently-updated bills. Optional filters: chamber, session, sponsor_entity_id (civic entity UUID, resolved to OpenStates OCD id), classification, subject, introduced_since/until, updated_since/until, sort. Any explicit date range overrides days. Pass a jurisdiction like 'us-tx' or 'us-ca'; '*' queries all cached jurisdictions locally. Useful for 'what did this legislator introduce' and 'recent bills on ' queries.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/julianken/civic-awareness-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server