open-index/open-npm huggingface dataset:
npm package: @munispot/mcp
Description: MCP server for MuniSpot municipal financial data — connects any MCP client to 14,800+ US municipalities
Latest version: 1.0.0

# @munispot/mcp

MCP server for **MuniSpot** — query financial health scores, budgets, debt levels, and economic indicators for 14,800+ US municipalities.

## Quick Start

### Option 1: Streamable HTTP (recommended)

Add to your MCP client config (Claude Desktop, Cursor, etc.):

```json
{
  "mcpServers": {
    "munispot": {
      "url": "https://www.munispot.com/api/mcp",
      "headers": {
        "X-API-Key": "ms_live_your_key_here"
      }
    }
  }
}
```

### Option 2: stdio (via npx)

```json
{
  "mcpServers": {
    "munispot": {
      "command": "npx",
      "args": ["-y", "@munispot/mcp"],
      "env": {
        "MUNISPOT_API_KEY": "ms_live_your_key_here"
      }
    }
  }
}
```

## Getting an API Key

1. Sign up at [munispot.com](https://www.munispot.com)
2. Subscribe to **API Professional** at `/pricing`
3. Create an API key at `/account/api-keys`

Free-tier keys (100 calls/month) also work for basic queries.

## Tools

| Tool | Description | Tier |
|------|-------------|------|
| `search_municipalities` | Search by name, state, sector, score range, population | All |
| `get_municipality` | Detailed profile with full MuniScore breakdown | All |
| `get_financials` | ACFR line items (balance sheet, income, obligations) | Pro+ |
| `get_scores_history` | MuniScore across all fiscal years | All |
| `compare_municipalities` | Side-by-side comparison of 2-10 entities | All |
| `get_economy` | Economic/demographic data by EIN, CBSA, or state | All |

## Examples

Ask your AI assistant:

- "Find Ohio cities with a MuniScore below 50"
- "Compare Austin TX and Denver CO finances"
- "Show me the debt-to-revenue trend for Phoenix"
- "What's the poverty rate in the Phoenix metro area?"

## License

MIT