Contribute from your terminal

A Claude Code skill that connects you to the governments that serve your address. Explore what's there, find what's missing, and fill the gaps — all from the CLI.

View on GitHub

Install

Run these two commands inside Claude Code. They install the gather skill and connect it to the jurisdictional.org API.

> /plugin marketplace add jurisdictional/jurisdictional-skill
> /plugin install jurisdictional@jurisdictional

Start a new session, then:

> /gather 300 Hemlock St, Vacaville, CA

Requires Claude Code. Exploring works right away, with no account.

To use the API without the skill: claude mcp add --transport http jurisdictional https://jurisdictional.org/api/mcp/message

How it works

1

Set your location

Give an address or city. The skill geocodes it and returns your juricode — every layer of government from federal to school district.

2

Explore what's known

See the agencies, bodies, officials, and services already on file. Pick a topic — education, housing, public safety — or browse everything. Gaps are highlighted: "No one has added the planning commission yet."

3

Research and fill gaps

The skill fetches government websites using a headless browser (the gather tool), extracts structured data, and presents it for your review. You correct what's wrong, add what you know, and approve before anything is submitted.

4

Submit directly to jurisdictional.org

Contributions go through the MCP API — create_entity for new agencies and bodies, propose_change for field updates. Each returns a link you can click to verify on the site. Changes appear in real time.

Data hierarchy

Civic data builds up in layers. The skill follows this order — you can't add people without positions, positions without bodies, bodies without agencies. 

Jurisdiction  (already exists via juricode)
  └── Agency  (city departments, offices)
        ├── Service  (permits, programs, hotlines)
        ├── Body  (council, commission, board)
        │     └── Position  (Mayor, Council Seat 1)
        │           └── Person → Tenure
        └── Position  (department head, director)

Authentication

Exploring works without signing in. The MCP read tools are public.

To research pages and submit contributions, sign in once:

  1. Visit jurisdictional.org/auth/cli and copy your token.
  2. Save it where the plugin reads it, without pasting it into the chat:
> ! mkdir -p ~/.jurisdictional && pbpaste > ~/.jurisdictional/token && chmod 600 ~/.jurisdictional/token

On Linux, use xclip -o -selection clipboard in place of pbpaste.

  1. Run /mcp and reconnect jurisdictional, or start a new session.

The plugin sends the token only when that file exists. Tokens are managed in Settings.

What you can contribute

Agencies

City departments, offices, authorities

Governing bodies

Councils, commissions, boards

Officials & positions

Who holds office and what seats exist

Services

Permits, programs, hotlines

Contact info

Phone, email, address, website

Meeting schedules

When governing bodies meet

Real-time feedback

Open jurisdictional.org while running the skill. Every create_entity and propose_change appears on the site instantly — entity pages, your contributions list, and the juricode activity feed all update in real time via PubSub.

The skill returns a direct URL for every contribution. Click it to verify. Come back to the conversation with corrections.

Pick your city

Start with where you live.

Get the skill Try Juricode first

Join the community

Ask questions, share what you're finding, and coordinate coverage with other contributors.

Join us on Discord