MCP Server

MuniSpot data, now in Claude, Gemini, and other MCP-compatible AI tools.

The MuniSpot MCP server connects your AI client directly to our database of standardized financial statements, MuniScore™ ratings, and economic indicators. No API calls to write. No JSON to parse.

Example prompts

“Which cities in Ohio have a fund balance below 15% and a MuniScore under 50?”

“Compare the debt ratios for Phoenix, Denver, and Austin over the last five years.”

“What is the financial summary for Cook County's latest fiscal year?”

What is MCP?

MCP (Model Context Protocol) is an open standard developed by Anthropic that lets AI tools connect to external data sources and services. When you add MuniSpot as an MCP server, your AI client can search, filter, and retrieve municipal financial data as part of a conversation.

This is different from the REST API: instead of making HTTP requests and parsing JSON, you simply ask your AI tool a question in plain English. The AI handles the tool calls, parameters, and response formatting automatically.

Authentication

MCP access uses the same API key as the REST API. Your plan tier determines your monthly tool call limit, shared across both REST and MCP usage. Pass your key in the MCP client configuration:

Server URL

https://www.munispot.com/api/mcp

Header

Authentication Header

X-API-Key: ms_live_your_key_here

Don't have an API key? Visit Pricing to get started. Free tier includes 100 tool calls per month.

Compatible Clients

MuniSpot's MCP server works with any MCP-compatible client. Below are setup instructions for the most common tools.

Client	Type
Claude Desktop	Desktop app
Cursor	Code editor
Claude Code	CLI
GitHub Copilot (VS Code)	Code editor
Gemini CLI	CLI
ChatGPT	Web app (Developer Mode)

Claude Desktop

Add the following to your claude_desktop_config.json file:

claude_desktop_config.json

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

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

Cursor

Go to Cursor Settings → MCP → Add Server. Enter the server URL and add the X-API-Key header with your key.

Claude Code

Run the following command in your terminal:

Terminal

claude mcp add munispot \
  --url https://www.munispot.com/api/mcp \
  --header "X-API-Key: ms_live_your_key_here"

GitHub Copilot (VS Code)

Add the following to your .vscode/mcp.json file:

.vscode/mcp.json

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

Then open Copilot Chat, select Agent mode, and the MuniSpot tools will appear in the tool picker.

Gemini CLI

Add the following to your Gemini CLI settings.json file:

settings.json

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

ChatGPT (Developer Mode)

In ChatGPT, go to Settings → Apps & Connectors → Advanced settings and enable Developer Mode. Then go to Settings → Apps & Connectors → Create and enter the MuniSpot MCP server URL and your API key.

Developer Mode is available on Pro, Plus, Business, Enterprise, and Education plans.

One-click install via Smithery

Smithery URL

https://smithery.ai/server/com.munispot/municipal-data

Rate Limits

Tool call limits are shared between REST API and MCP usage within the same API key. The limit resets on the first day of each calendar month.

Feature	Starter	Professional	Enterprise
Monthly tool calls	100	25,000	Unlimited
Per-minute limit	30	30	Custom
All 6 tools included
Shared with REST API limit

Tools

The MuniSpot MCP server exposes 6 tools. Each tool call counts as one request against your monthly limit.

`search_municipalities`

Search and filter municipalities by name, state, sector, or population. Returns up to 25 results with basic profile data. Use get_municipality to retrieve scores for individual results.

Key parameters

Name	Type	Description
`query`	string	Name search (e.g. “Phoenix”, “Cook County”)
`state`	string	Two-letter state code (e.g. “OH”, “CA”)
`sector`	string	`city` \| `county` \| `school_district` \| `special_district` \| `state`
`min_score / max_score`	number	Filter by MuniScore range (1–99)
`min_population / max_population`	number	Filter by population range
`per_page`	number	Results per page (default 25, max 25)

Example prompt

“Find California cities with a MuniScore above 70 and fund balance over 20%”

`get_municipality`

Get the full financial health profile for a single municipality: all MuniScore sub-scores, key ratios, and the pre-generated financial narrative summary.

Key parameters

Name	Type	Description
`ein`required	string	EIN identifier (e.g. “86-0006490”)
`fiscal_year`	number	Optional; defaults to latest available

Example prompt

“What is the full financial profile for the City of Phoenix?”

`get_financials`

Get standardized ACFR financial statement line items for a municipality. Returns income statement and balance sheet data for one or more fiscal years.

Key parameters

Name	Type	Description
`ein`required	string	EIN identifier
`fiscal_year`required	number	Fiscal year to retrieve data for
`statement_type`	string	`income_statement` \| `reconciliation` \| `all`
`class_1_filter`	string	Filter to specific line items (e.g. `TOTAL REVENUES`, `FUND BALANCES ENDING`)

Example prompt

“Show me the revenue and expenditure trends for Denver over the last five years”

`get_scores_history`

Get MuniScore and sub-score history across all available fiscal years for a municipality. Useful for trend analysis and identifying improving or deteriorating credits.

Key parameters

Name	Type	Description
`ein`required	string	EIN identifier

Example prompt

“Has Austin's debt score improved or worsened over the last five years?”

`compare_municipalities`

Compare financial health metrics across 2\u201310 municipalities side by side.

Key parameters

Name	Type	Description
`eins`required	string[]	Array of EIN identifiers (2–10 municipalities)
`fiscal_year`	number	Optional; defaults to most recent common year
`metrics`	string[]	Specific metrics to compare, or all if omitted

Example prompt

“Compare the debt ratios for Phoenix, Denver, and Austin”

`get_economy`

Get Census economic and demographic data for a municipality: population, median household income, unemployment rate, poverty rate, median home value, and labor force participation.

Key parameters

Name	Type	Description
`ein`required	string	EIN identifier
`year`	number	Optional; defaults to most recent available

Example prompt

“What is the economic profile of Cook County, Illinois?”

Ready to get started?

Get a free API key and start querying municipal data from your AI tools.