Philly — Philadelphia open data

Search Philadelphia public data from your terminal, Python, or MCP client.

Terminal

uv tool install philly

Python

uv add philly

MCP stdio

git clone https://github.com/h0rv/philly.git
cd philly/mcp
npm ci
npm run stdio

Remote MCP

https://your-worker.example/mcp

Your deployed endpoint.

Examples

phl search "crime"
phl info "Crime Incidents"
phl sample "Crime Incidents" --limit 5

Or ask an agent

Agent installed and signed in · replace the URL with your deployed MCP endpoint.

Claude Code

claude "Use the philly MCP server to find building-permit datasets and show five sample records with source links." --strict-mcp-config --mcp-config '{"mcpServers":{"philly":{"type":"http","url":"https://YOUR-PHILLY-MCP-HOST/mcp"}}}'

Connection for this run only. Setup docs

Codex

codex -c 'mcp_servers.philly.url="https://YOUR-PHILLY-MCP-HOST/mcp"' "Use the philly MCP server to find building-permit datasets and show five sample records with source links."

Connection for this run only. Setup docs

Pi

pi mcp add philly --url https://YOUR-PHILLY-MCP-HOST/mcp && pi --print "Use the philly MCP server to find building-permit datasets and show five sample records with source links."

Saves or replaces the philly connection in Pi. Setup docs

Client setup