SF Permits

Provides access to San Francisco permitting, business, and property data via MCP tools using the Socrata SODA API.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tbrennem-source-sf-permits-mcp": {
      "command": "python",
      "args": [
        "-m",
        "src.server"
      ],
      "env": {
        "SODA_APP_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

This MCP server exposes San Francisco public permitting data to Claude, built with FastMCP and the Socrata SODA API. It provides fast, queryable access to permits, businesses, property data, and related enrichment to support analytics and conversational data queries.

How to use

You will interact with this MCP server through an MCP client. The server translates your queries into requests against the Socrata SODA API for San Francisco data, formats the results, and returns structured responses you can render in a conversation or UI.

How to install

Prerequisites: Python and a compatible runtime where you can run the MCP server. You will need a working Python environment and internet access to fetch dependencies and data.

Additional resources

This server uses the Socrata SODA API from DataSF for a catalog of datasets related to permits, contacts, violations, and enrichment. A token may be used to increase API rate limits when hitting the live SODA endpoint.

Notes on architecture

The system routes Claude’s MCP tool calls to this server, which queries the SODA API and returns structured results suitable for Claude to render to the user.

Phase and scope

Phase 1 implements the MCP server, dataset catalog, and performance benchmarks. Future phases will add local storage, enhanced contact data ingestion, fraud detection, and predictive analytics.

Available tools

search_permits

Search building permits by neighborhood, type, status, cost, date, address, or description.

get_permit_details

Get full details for a specific permit by permit number.

permit_stats

Aggregate statistics grouped by neighborhood, type, status, month, or year.

search_businesses

Search registered business locations in San Francisco.

property_lookup

Look up property assessments by address or block/lot.