MCP for AI Agents

Connect AI assistants directly to UnGovr government data using the Model Context Protocol

https://mcp.ungovr.org/mcp

Claude Desktop

Add the UnGovr MCP server to your Claude Desktop configuration file (claude_desktop_config.json):

claude_desktop_config.json

{
  "mcpServers": {
    "ungovr": {
      "transport": "http",
      "url": "https://mcp.ungovr.org/mcp"
    }
  }
}

Claude Code

Add the server directly from the command line:

Terminal

claude mcp add ungovr --transport http https://mcp.ungovr.org/mcp

Available Tools

The MCP server exposes the following tools that AI agents can call:

Tool	Description
`list_countries`	List all countries with entity counts and coverage status
`search_entities`	Search government entities by name, type, or location
`get_entity`	Get full details for a specific entity including contacts and domains
`search_cgj_reports`	Search grand jury reports by county, year, or keyword
`get_cgj_report`	Get full report detail with findings and recommendations

Example Queries

Once connected, you can ask your AI assistant questions like:

How many government entities does UnGovr track in California?
What is the parent entity of the City of San Buenaventura?
Show me grand jury reports about homelessness in Ventura County
Which countries have the most government entities in the database?
List all counties in Ireland with their entity types
What were the key findings in the latest Los Angeles County grand jury report on jails?

MPP: Rate Limits & Payments

Each tool has a free-tier limit (e.g., 100 entity lookups/day, 50 CGJ reports/day). Beyond those limits, the server returns a JSON-RPC -32042 payment challenge using the Machine Payments Protocol (MPP).

Tool	Price per call
`list_countries`, `search_entities`, `get_entity`	$0.001
`search_cgj_reports`, `get_cgj_report`	$0.01
`list_service_types`	$0.001
`submit_service_request` (text only)	$0.01
`submit_service_request` (with images)	$0.05

Agents pay by pre-loading a wallet ($5.00 minimum) via Stripe, then including an _meta.credential with their Stripe Payment Token on retry. Successful paid requests include an _meta.receipt with the updated wallet balance.

View REST API Reference