{"openapi":"3.1.0","info":{"title":"TownBrief — Massachusetts Local Government Intelligence","description":"Real-time access to local government meeting articles, transcripts, news roundups, town calendars, and full-text search across AI-generated coverage of Massachusetts town meetings produced by The Wayland Post journalism pipeline. Subscribe at wayland.ma.townbrief.com for access.","version":"1.0.0"},"servers":[{"url":"https://api.townbrief.com"}],"paths":{"/api/list_recent_meetings":{"get":{"operationId":"listRecentMeetings","summary":"List recent government meetings for a town, newest first","parameters":[{"name":"town","in":"query","schema":{"type":"string","default":"wayland"}},{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"List of meetings with meeting_id, committee, date, artifacts"}}}},"/api/get_article":{"get":{"operationId":"getArticle","summary":"Get AI-generated article, brief, and headlines for a meeting","parameters":[{"name":"meeting_id","in":"query","required":true,"schema":{"type":"string"},"description":"{Committee}/{YYYY-MM-DD}"},{"name":"town","in":"query","schema":{"type":"string","default":"wayland"}},{"name":"fields","in":"query","schema":{"type":"string","default":"article,brief"},"description":"Comma-separated fields to return: article, article_plus, brief, headlines, review. Use 'all' for everything."}],"responses":{"200":{"description":"Requested article fields"}}}},"/api/get_transcript":{"get":{"operationId":"getTranscript","summary":"Get the Whisper-generated transcript for a meeting","parameters":[{"name":"meeting_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"town","in":"query","schema":{"type":"string","default":"wayland"}},{"name":"format","in":"query","schema":{"type":"string","enum":["txt","srt"],"default":"txt"}},{"name":"max_chars","in":"query","schema":{"type":"integer","default":20000},"description":"Truncate transcript to this many chars (0 = full text). Default 20000 (~5000 words)."}],"responses":{"200":{"description":"Transcript text (may be truncated)"}}}},"/api/get_committee_summary":{"get":{"operationId":"getCommitteeSummary","summary":"Get brief summaries across a committee's recent meetings","parameters":[{"name":"committee","in":"query","required":true,"schema":{"type":"string"}},{"name":"town","in":"query","schema":{"type":"string","default":"wayland"}},{"name":"since","in":"query","schema":{"type":"string"},"description":"ISO date lower bound"},{"name":"limit","in":"query","schema":{"type":"integer","default":12}}],"responses":{"200":{"description":"List of meetings with briefs"}}}},"/api/search_meetings":{"get":{"operationId":"searchMeetings","summary":"Full-text search across AI-generated meeting articles","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"town","in":"query","schema":{"type":"string","default":"wayland"}},{"name":"committee","in":"query","schema":{"type":"string"}},{"name":"date_from","in":"query","schema":{"type":"string"}},{"name":"date_to","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Matching meetings with snippets"}}}},"/api/list_recent_roundups":{"get":{"operationId":"listRecentRoundups","summary":"List recent daily news roundup dates","parameters":[{"name":"town","in":"query","schema":{"type":"string","default":"wayland"}},{"name":"limit","in":"query","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"List of roundup dates"}}}},"/api/get_roundup":{"get":{"operationId":"getRoundup","summary":"Get the daily news roundup for a specific date","parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string"},"description":"YYYY-MM-DD"},{"name":"town","in":"query","schema":{"type":"string","default":"wayland"}}],"responses":{"200":{"description":"Full roundup article, brief, sources, headlines"}}}},"/api/get_town_calendar":{"get":{"operationId":"getTownCalendar","summary":"Get upcoming events from a town calendar","parameters":[{"name":"town","in":"query","schema":{"type":"string","default":"wayland"}},{"name":"calendar","in":"query","schema":{"type":"string","enum":["town","arts","library"],"default":"town"}},{"name":"days_ahead","in":"query","schema":{"type":"integer","default":30}}],"responses":{"200":{"description":"List of upcoming events"}}}},"/api/search_waylandarchive":{"get":{"operationId":"searchWaylandArchive","summary":"Search the Wayland town archive (6,000+ historical documents)","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Matching archive documents with snippets"}}}},"/api/search_waylandenews":{"get":{"operationId":"searchWaylandEnews","summary":"Search 5,500+ historical Wayland eNews posts (2013-2024)","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"date_from","in":"query","schema":{"type":"string"}},{"name":"date_to","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Matching eNews posts with URLs"}}}},"/api/search_waylandpost":{"get":{"operationId":"searchWaylandPost","summary":"Search published Wayland Post articles","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Matching Wayland Post articles"}}}},"/api/list_counties":{"get":{"operationId":"listCounties","summary":"List all MA counties with pipeline coverage and their member towns","parameters":[],"responses":{"200":{"description":"List of counties with town_count and towns array"}}}},"/api/list_county_meetings":{"get":{"operationId":"listCountyMeetings","summary":"List recent meetings across all towns in a county","parameters":[{"name":"county","in":"query","required":true,"schema":{"type":"string"},"description":"County slug (e.g. 'middlesex', 'barnstable', 'norfolk')"},{"name":"limit","in":"query","schema":{"type":"integer","default":30}}],"responses":{"200":{"description":"Aggregated meetings across all county towns, newest first"}}}},"/api/search_county_meetings":{"get":{"operationId":"searchCountyMeetings","summary":"Full-text search across meeting articles for all towns in a county","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"}},{"name":"county","in":"query","required":true,"schema":{"type":"string"},"description":"County slug"},{"name":"committee","in":"query","schema":{"type":"string"}},{"name":"date_from","in":"query","schema":{"type":"string"}},{"name":"date_to","in":"query","schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Matching meetings with snippets across all county towns"}}}},"/api/search_bylaws":{"get":{"operationId":"searchBylaws","summary":"Full-text search across municipal codes, bylaws, and zoning regulations","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"description":"Search terms (e.g. 'accessory dwelling', 'stormwater', 'sign bylaw')"},{"name":"town","in":"query","schema":{"type":"string"},"description":"Limit to one town slug (omit to search all)"},{"name":"chapter","in":"query","schema":{"type":"string"},"description":"Limit to chapters whose title contains this string"},{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Matching bylaw sections with snippets"}}}},"/api/list_bylaw_towns":{"get":{"operationId":"listBylawTowns","summary":"List all MA municipalities with downloaded municipal codes / bylaws","parameters":[],"responses":{"200":{"description":"List of towns with chapter counts"}}}},"/api/list_bylaw_chapters":{"get":{"operationId":"listBylawChapters","summary":"List all chapters in a town's municipal code / bylaws","parameters":[{"name":"town","in":"query","required":true,"schema":{"type":"string"},"description":"Town slug"}],"responses":{"200":{"description":"Table of contents with chapter titles and section counts"}}}},"/api/get_bylaw_chapter":{"get":{"operationId":"getBylawChapter","summary":"Get full text of a specific bylaw chapter","parameters":[{"name":"town","in":"query","required":true,"schema":{"type":"string"},"description":"Town slug"},{"name":"chapter_index","in":"query","required":true,"schema":{"type":"integer"},"description":"0-based chapter index from list_bylaw_chapters"}],"responses":{"200":{"description":"Full chapter text with sections"}}}},"/api/search_wells":{"get":{"operationId":"searchWells","summary":"Search waylandwells.ma.townbrief.com (Wayland Wells private-well monitoring hub — PFAS resources, committee history)","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"description":"Search terms"},{"name":"limit","in":"query","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Matching pages with snippets"}}}},"/api/get_archive_page":{"get":{"operationId":"getArchivePage","summary":"Full text + metadata for a specific Wayland town archive document by doc_id","parameters":[{"name":"doc_id","in":"query","required":true,"schema":{"type":"string"},"description":"16-char hex id from search_waylandarchive results"}],"responses":{"200":{"description":"Full document text and metadata"}}}},"/api/search_wvn":{"get":{"operationId":"searchWvn","summary":"Search wvn.ma.townbrief.com (Wayland Video News static site — About and Archive pages)","parameters":[{"name":"query","in":"query","required":true,"schema":{"type":"string"},"description":"Search terms"},{"name":"limit","in":"query","schema":{"type":"integer","default":10}}],"responses":{"200":{"description":"Matching pages with snippets"}}}},"/api/get_waylandpost_post":{"get":{"operationId":"getWaylandpostPost","summary":"Full text of a Wayland Post article by slug (source: waylandpost.org)","parameters":[{"name":"slug","in":"query","required":true,"schema":{"type":"string"},"description":"Article slug from search_waylandpost results"}],"responses":{"200":{"description":"Full article text and metadata"}}}}},"components":{"securitySchemes":{"oauth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://api.townbrief.com/authorize","tokenUrl":"https://api.townbrief.com/token","scopes":{"mcp":"Access TownBrief meeting intelligence"}}}}}},"security":[{"oauth2":["mcp"]}]}