@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.):

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

Option 2: stdio (via npx)

{
  "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
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