MCP server

MuniSpot data, inside Claude, Gemini and other AI tools.

The MuniSpot MCP server connects your AI client to our standardized financial statements, MuniScore 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 from Anthropic that lets AI tools connect to outside data sources and services. Add MuniSpot as an MCP server and your AI client can search, filter and retrieve municipal financial data inside a conversation.

It differs from the REST API: instead of making HTTP requests and parsing JSON, you ask your AI tool a question in plain language. The client handles the tool calls, parameters and formatting.

Authentication

MCP uses the same API key as the REST API. Your plan sets your monthly tool-call limit, shared across REST and MCP. Pass the key in your client's MCP configuration.

Server URL

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

Authentication header

X-API-Key: ms_live_your_key_here

No API key yet? See Pricing to get started. The free tier includes 100 tool calls a month.

Compatible clients

The server works with any MCP-compatible client. Setup for the most common ones:

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 this 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

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

Claude Code

Run this 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 this 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, choose Agent mode, and the MuniSpot tools appear in the tool picker.

Gemini CLI

Add this 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, open Settings, Apps and Connectors, Advanced settings and turn on Developer Mode. Then open Settings, Apps and Connectors, Create and enter the MuniSpot 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 calls share one limit with REST requests on the same API key. The limit resets on the first day of each calendar month.

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

Tools

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

TOOLsearch_municipalities

Search and filter municipalities by name, state, sector or population. Returns up to 25 results with basic profile data. Use get_municipality for scores on 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` \| `utility` \| `community_college` \| `public_university`
min_score / max_score	number	Filter by MuniScore range (1 to 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%.”

TOOLget_municipality

The full financial health profile for one government: every MuniScore sub-score, key ratios and the pre-generated financial summary.

Key parameters

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

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

TOOLget_financials

Standardized financial statement line items for one government and fiscal year. Governments return the balance sheet, income statement, reconciliation and long-term obligations; utilities and community colleges return their business-type statements (net position, revenues and expenses, cash flows, and a utility's printed debt service coverage).

Key parameters

Name	Type	Description
einrequired	string	EIN identifier
fiscal_yearrequired	number	Fiscal year to retrieve
statement_type	string	Governments: `balance_sheet` \| `income_statement` \| `reconciliation_statement` \| `long_term_obligations`. Utilities and community colleges: `bta_net_position` \| `bta_activities` \| `bta_cash_flows` \| `bta_coverage`. Omit for all.
fund_type	string	Filter by fund type
column_index	number	Governments: `1` = General Fund, `-1` = Total Governmental Funds. Utilities: one column per system in page order, `-1` = printed total.

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

TOOLget_scores_history

MuniScore and sub-score history across every available fiscal year for one government. Useful for spotting improving or deteriorating credits. Each year carries its scorecard: v5 for governments, ut_v1 for utilities (factors economy, system, liquidity, debt, with factor_details). Compare scores only within one scorecard.

Key parameters

Name	Type	Description
einrequired	string	EIN identifier

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

TOOLcompare_municipalities

Compare financial health metrics across 2 to 10 governments side by side.

Key parameters

Name	Type	Description
einsrequired	string[]	Array of EIN identifiers (2 to 10 governments)
fiscal_year	number	Optional; defaults to the most recent common year
metrics	string[]	Metrics to compare, or all if omitted

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

TOOLget_economy

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

Key parameters

Name	Type	Description
einrequired	string	EIN identifier
year	number	Optional; defaults to the most recent available

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

Ready to start?

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

Get an API key →View the REST API docs