Commonwealth-MCP

What you can ask

Each card links to the call that answered it.

Quick start

Four steps from an empty directory to a real answer. Nothing here needs a key, an account, or a network, except where a step is marked live.

Python 3.12 and uv. Keep the checkout: the runtime loads source manifests and skills from these directories, so it is the installation, not just its source. The package is not on PyPI yet (issue #40), so the checkout is the only path that runs.

git clone https://github.com/pranava0x0/Commonwealth-MCP.git
cd Commonwealth-MCP
uv venv --python 3.12 .venv
uv pip install --python .venv/bin/python -e . --group dev

This run needs no network. Adding --live queries every registered source and reports what answered, which is how you find out that a county changed an endpoint before a question does.

.venv/bin/commonwealth doctor

One install gets both halves. Adding the marketplace registers the server and installs the workflow skills with it; configure writes a server entry on its own, for a client with no plugin system.

Or, per client:

Each of these is a question the recorded trail already answers, so you can read the answer before you run it.

Or run it without a client

Six scripts under examples/, each a real question with a printed answer, replaying recorded responses so a first run cannot fail on a service being down. The CLI calls any tool directly; the second command goes out to Fairfax County.

.venv/bin/python examples/whose_government.py
.venv/bin/commonwealth tools call geo.find_zoning \
  --args '{"jurisdiction": "Fairfax County", "pin": "0102 14  0231"}'

That zoning answer is screening evidence, and the caveat is attached to it. live

One walk, four answers

All 39 recorded calls, grouped by what each walk demonstrates, with the full answer and the outbound HTTP for every one.

Try the jurisdiction resolver

Enter a place name or FIPS code. Try fairfax to see the city and county come back as separate candidates rather than a guess. Answers are computed from the project jurisdiction table when this page is built.

Place name or FIPS code

Workflows

A skill bundles several tool calls into one workflow and adds what the tools do not know: which order to ask in, and what an empty answer means at each step. Each shipped skill is on disk with its own eval tasks, and commonwealth skills list prints where they are.

This list needs JavaScript. The skills are in plugins/commonwealth-mcp/skills/, one SKILL.md each.

Coverage

An answer that finds nothing says which kind of nothing: the records were searched and came back empty, or no source is registered for that place. The decoder defines every coverage value and warning code and names a call that produced it. Read-only throughout: this server fetches published records and submits nothing.

Where each question works

Reference

Tools

Search every callable function by name, package, or what it does, and read the description the model reads.

Sources

See what each registered government system answers, whose terms apply, and what it does not cover.

Examples

Read the full recorded trail, decode any coverage value or warning code, and try the jurisdiction resolver.