Metadata-Version: 2.4
Name: munimind-mcp
Version: 0.3.0
Summary: MCP server for MuniMind — tools + prompts + resources for 2,500+ civic datasets from Claude Desktop, Claude Code, Cursor.
Author-email: Rob <rob@easyexit.com>
License: MIT
Project-URL: Homepage, https://munimind.com/developers/data
Project-URL: Repository, https://github.com/munimind/munimind-mcp
Project-URL: Issues, https://github.com/munimind/munimind-mcp/issues
Keywords: mcp,civic-data,socrata,nyc,open-data,municipal,claude
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.7

# munimind-mcp

MCP server for [MuniMind](https://munimind.com) — query 2,500+ civic datasets
across NYC, Nashville, and more directly from Claude Desktop, Claude Code, or
Cursor.

## What you can do

Once installed, ask Claude natural-language questions that route through
MuniMind's API:

- *"List all MuniMind datasets about housing violations."*
- *"Show me the schema for NYC's HPD violations dataset."*
- *"How many DOB violations were issued in Queens in 2024?"* (runs SQL)
- *"What's the ownership history for BBL 1000010010?"* (Answers API)
- *"Preview the first 20 rows of the NYC taxi zones dataset."*

## Install

```bash
pip install munimind-mcp
```

Or via `uv`:

```bash
uv pip install munimind-mcp
```

## Get an API key

1. Go to https://munimind.com/developers
2. Sign up for Free, Pro, or Enterprise
3. Create an API key in the developer dashboard
4. Copy the key (starts with `mm_live_`)

## Configure your MCP client

### Claude Desktop / Claude Code

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS)
or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "munimind": {
      "command": "munimind-mcp",
      "env": {
        "MUNIMIND_API_KEY": "mm_live_..."
      }
    }
  }
}
```

Or from the Claude Code CLI:

```bash
claude mcp add munimind --command munimind-mcp --env MUNIMIND_API_KEY=mm_live_...
```

### Cursor

Add to `.cursor/mcp.json` in your workspace or `~/.cursor/mcp.json` globally:

```json
{
  "mcpServers": {
    "munimind": {
      "command": "munimind-mcp",
      "env": { "MUNIMIND_API_KEY": "mm_live_..." }
    }
  }
}
```

## Available tools

| Tool | Description | Credit cost |
|------|-------------|-------------|
| `list_datasets` | List public datasets (optionally filter by city, keyword) | 0 |
| `describe_dataset` | Full metadata + schema for one dataset | 0 |
| `preview_dataset` | First 100 rows of a dataset | 0 |
| `query_dataset` | Run SQL against DuckLake-backed datasets | dynamic (bytes scanned) |
| `property_summary` | Per-property summary via the Answers API | 1 |
| `property_intelligence` | Full property dossier | 5 |
| `owner_portfolio` | Cross-property analysis for an owner | 10 |

## Environment variables

| Name | Required | Default | Notes |
|------|----------|---------|-------|
| `MUNIMIND_API_KEY` | yes | — | Your API key from the developer dashboard |
| `MUNIMIND_API_BASE_URL` | no | `https://api.munimind.com` | Override for staging / self-hosted |

## License

MIT

## Report issues

https://github.com/munimind/munimind-mcp/issues
