Start
Overview
One dataset of what local governments publish, served two ways with one key: a REST API and a hosted MCP server.
Hey Town Hall Data is one dataset of what local governments publish: meetings and minutes, bylaws, budgets, bids, permits, officials and notices. You reach it two ways, with one key.
- The MCP server at
https://data.heytownhall.com/mcp. Connect the AI model your company uses, and your AI client calls its tools. - The REST API at
https://data.heytownhall.com/v1. JSON over HTTPS for your own code, read withGET, paged by cursor.
Both read the same records through the same gate. They share the same rate limits and the same bill, and one tool call is one API request.
Coverage today is British Columbia. The United States is being added.
What every record carries
Every record carries source_url, the public page or document it was read from, and read_at, when it was read. Cite them.
A value that could not be read is null. Null means unknown, never no.
Start here
Quickstart
Authentication and keys
The sandbox
Connect the MCP server
Using the API
Pagination and filters
The change feed
Errors
Rate limits
Billing and the spending cap
The records
The records are filed in seven drawers, plus the topics that cut across them.
Meetings
Laws
Money
Development
People
Places
Public word
Topics
Search
Coverage
API reference
Every endpoint has a reference page with its parameters, its answer and a playground. The pages are built from the API's own OpenAPI 3.1 document at https://data.heytownhall.com/openapi.json, so they say what the API does.