Skip to content
MCP server

Socrata MCP Server

Search and query government open-data portals (Socrata SODA API).

Install
Pricing
Open source
Runs
Locally or Remotely
Version
0.7.0
Listing updated
4 days ago

About Socrata MCP Server

Socrata MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.

Install

Run in a terminal

claude mcp add --transport http socrata-mcp-server https://socrata.caseyjhand.com/mcp

Add to Settings → Connectors → Add custom connector

https://socrata.caseyjhand.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "socrata-mcp-server": {
      "url": "https://socrata.caseyjhand.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "socrata-mcp-server": {
      "type": "http",
      "url": "https://socrata.caseyjhand.com/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "socrata-mcp-server": {
      "serverUrl": "https://socrata.caseyjhand.com/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "socrata-mcp-server": {
      "type": "http",
      "url": "https://socrata.caseyjhand.com/mcp"
    }
  }
}

Configuration

  • SOCRATA_APP_TOKENSocrata app token (X-App-Token header). Without a token, requests share a throttled pool per source IP. Free to register at any Socrata portal.
  • SOCRATA_DEFAULT_DOMAINDefault portal domain when domain is omitted from tool calls (e.g. data.seattle.gov, data.cityofnewyork.us).
  • SOCRATA_DATAFRAME_DROP_ENABLEDSet to true to enable socrata_dataframe_drop, which deletes staged DataCanvas data. Off, the tool is omitted from the tool list.
  • SOCRATA_CLAMP_LIMITSServe a limit above a tool's per-call cap at the cap, with a notice naming the offset that continues, instead of rejecting it. Set to false to restore each cap as the schema maximum.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
  • MCP_TRANSPORT_TYPESelects the HTTP transport.
  • SOCRATA_APP_TOKENSocrata app token (X-App-Token header). Without a token, requests share a throttled pool per source IP. Free to register at any Socrata portal.
  • SOCRATA_DEFAULT_DOMAINDefault portal domain when domain is omitted from tool calls (e.g. data.seattle.gov, data.cityofnewyork.us).
  • SOCRATA_DATAFRAME_DROP_ENABLEDSet to true to enable socrata_dataframe_drop, which deletes staged DataCanvas data. Off, the tool is omitted from the tool list.
  • SOCRATA_CLAMP_LIMITSServe a limit above a tool's per-call cap at the cap, with a notice naming the offset that continues, instead of rejecting it. Set to false to restore each cap as the schema maximum.
  • MCP_HTTP_HOSTThe hostname for the HTTP server.
  • MCP_HTTP_PORTThe port to run the HTTP server on.
  • MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.
  • MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.
  • MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').

Pricing

Open source

Socrata MCP Server FAQ

Is Socrata MCP Server free?

Yes. Socrata MCP Server is open source, so you can use and self-host it for free.

How do I add Socrata MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http socrata-mcp-server https://socrata.caseyjhand.com/mcp