civic-ai-tools

Overview

Civic AI Tools is an MCP server that enables AI assistants to access and query government open data through the Model Context Protocol. It primarily connects to NYC Open Data (Socrata) and Google Data Commons, allowing users to ask questions in plain English about civic datasets like 311 complaints, restaurant inspections, and demographic information. The platform includes anti-hallucination features that ensure responses are based on real, verifiable data rather than AI-generated content. It offers both local setup and cloud-based options through GitHub Codespaces.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• query_socrata

  Query NYC Open Data datasets including 311 complaints, restaurant inspections, and housing violations

  Try:What are the top 311 complaint types in NYC?Try:Show me restaurant inspection grades by boroughTry:Find housing violations in Manhattan
• query_data_commons

  Query Google Data Commons for population, income, and demographic data

  Try:Compare NYC's population trend with Los Angeles and ChicagoTry:What is the median income for California?Try:Show demographic statistics for Texas
• create_visualization

  Generate visualizations and dashboards from live civic datasets

  Try:Create a bar chart showing 311 complaints by typeTry:Generate a dashboard of restaurant inspection dataTry:Show me a time series of housing violations

Note: Tool names inferred from the MCP servers described in the table (Socrata MCP and Data Commons MCP) and their capabilities. No explicit tool names or signatures are provided in the README.

Comparable tools

Installation

git clone https://github.com/npstorey/civic-ai-tools.git
cd civic-ai-tools
cp .env.example .env
./scripts/setup.sh

{
  "mcpServers": {
    "civic-ai-tools": {
      "command": "uv",
      "args": ["run", "mcp/server.py"],
      "env": {
        "SOCRATA_APP_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

FAQ

What data sources are available?

The MCP server primarily connects to NYC Open Data (Socrata) with 2,000+ datasets and Google Data Commons with demographic and statistical indicators.

Do I need API keys to use this?

API keys are optional. NYC Open Data works with lower rate limits without keys, but Data Commons requires an API key for access.

Compare civic-ai-tools with