GoCodebook — California Building Codes
Verbatim California Title 24 and local zoning code lookup by section number, with citations.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"codes": {
"url": "https://gocodebook.com/api/mcp"
}
}
}원격 엔드포인트
https://gocodebook.com/api/mcpstreamable-http할 수 있는 일
도구 목록
도구 (3)
🟢lookup_california_code_section(section, jurisdiction, code, code_edition)
Look up the VERBATIM text of a California building, residential, fire, plumbing, mechanical, green (CALGreen), energy or existing-building code section, or a section of a California city or county zoning/municipal ordinance, by its section number. Use this whenever the user cites a section number ("CRC R602.10.2.3", "CBC 1004", "§ 17.60.090") or asks what a specific section says. Returns the official text with its citation, edition and a link to the full section. It returns code text only and does not determine whether a specific project complies.
입력 스키마
{
"type": "object",
"properties": {
"section": {
"type": "string",
"description": "The section number exactly as cited, without the code name. Examples: \"R602.10.2.3\", \"1004\", \"507.2\", \"17.60.090\", \"11B-206\"."
},
"jurisdiction": {
"type": "string",
"description": "Optional. A California city or county slug to scope the lookup to its own municipal code — \"los-angeles\", \"san-jose\", \"marin-county\". Omit for statewide Title 24 codes."
},
"code": {
"type": "string",
"description": "Optional. The code the user named, so a number that exists in several codes returns the right one. An abbreviation or a name: \"CBC\", \"CRC\", \"CFC\", \"CMC\", \"CPC\", \"CEC\", \"CEBC\", \"CALGreen\", \"CHBC\", \"California Fire Code\". Omit when the user gave no code name."
},
"code_edition": {
"type": "string",
"enum": [
"current",
"2022",
"2019"
],
"description": "Optional. Which Title 24 cycle to read. California enforces the edition in force when the permit application was submitted, so a project filed in 2024 is enforced under \"2022\". Defaults to \"current\" (the 2025 cycle, in force since 2026-01-01)."
}
},
"required": [
"section"
]
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"found",
"not_found",
"error"
],
"description": "found: at least one section matched. not_found: nothing matched — do NOT paraphrase a section that was not returned. error: the lookup could not run."
},
"query": {
"type": "object",
"properties": {
"section": {
"type": "string"
},
"jurisdiction": {
"type": "string"
},
"code": {
"type": [
"string",
"null"
]
},
"code_edition": {
"type": "string",
"enum": [
"current",
"2022",
"2019"
]
}
},
"required": [
"section",
"jurisdiction",
"code_edition"
]
},
"as_of": {
"type": [
"string",
"null"
],
"description": "The date the codes were read as of (YYYY-MM-DD), or null for the current edition."
},
"historical": {
"type": "boolean",
"description": "True when this is NOT the current code. Say so to the user."
},
"ambiguous": {
"type": "boolean",
"description": "True when the number exists in more than one code. Pick by the code the user named and say which one you used; never merge them."
},
"matches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"document_title": {
"type": "string"
},
"document_slug": {
"type": [
"string",
"null"
]
},
"section_number": {
"type": "string"
},
"heading": {
"type": "string"
},
"edition": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string",
"description": "Cite exactly this string."
},
"source_url": {
"type": [
"string",
"null"
],
"description": "Link to the full section. Always show it to the user."
},
"kind": {
"type": "string",
"enum": [
"text",
"subsection_list",
"empty"
],
"description": "text: an excerpt of the section's own words. subsection_list: the section has no text of its own and `excerpt` lists its subsections. empty: no text."
},
"excerpt": {
"type": "string"
},
"excerpt_truncated": {
"type": "boolean",
"description": "True when the excerpt is cut short. It is never the whole section."
}
},
"required": [
"document_title",
"section_number",
"heading",
"citation",
"source_url",
"kind",
"excerpt",
"excerpt_truncated"
]
}
},
"message": {
"type": [
"string",
"null"
],
"description": "Guidance when status is not_found or error."
},
"browse_url": {
"type": "string"
},
"applied_question_url": {
"type": "string",
"description": "Where to send a user whose real question is whether a specific project complies."
}
},
"required": [
"status"
]
}🟢list_california_code_documents(jurisdiction)
List the California codes and local ordinances available for lookup, and what is not covered. Useful before concluding that a code is unavailable, and for finding the exact document or jurisdiction slug that a lookup takes.
입력 스키마
{
"type": "object",
"properties": {
"jurisdiction": {
"type": "string",
"description": "Optional. A California city or county slug — returns the documents held for that jurisdiction instead of the statewide list."
}
}
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"not_found",
"empty",
"error"
]
},
"scope": {
"type": "string",
"enum": [
"statewide",
"jurisdiction"
]
},
"jurisdiction": {
"type": [
"object",
"null"
],
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
}
},
"required": [
"slug",
"name"
]
},
"groups": {
"type": "array",
"description": "Documents grouped by collection. Statewide: Title 24 first. Jurisdiction: the place's own documents, then those of the jurisdiction that also governs it.",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"label": {
"type": "string"
},
"documents": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"slug": {
"type": "string"
},
"edition": {
"type": [
"string",
"null"
]
},
"url": {
"type": [
"string",
"null"
]
}
},
"required": [
"title",
"slug"
]
}
}
},
"required": [
"key",
"label",
"documents"
]
}
},
"municipal": {
"type": [
"object",
"null"
],
"description": "Statewide only: how many local ordinances are held.",
"properties": {
"document_count": {
"type": "integer"
},
"jurisdiction_count": {
"type": "integer"
}
},
"required": [
"document_count",
"jurisdiction_count"
]
},
"editions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
},
"in_force": {
"type": "string"
}
},
"required": [
"id",
"label",
"in_force"
]
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Coverage caveats. Read them before telling a user a code is unavailable."
},
"message": {
"type": [
"string",
"null"
]
},
"browse_url": {
"type": "string"
},
"applied_question_url": {
"type": "string"
}
},
"required": [
"status"
]
}🟢search_california_codes(query, jurisdiction, sources, code_edition)
Search California building codes (Title 24), state housing law and California city and county zoning/municipal codes by TOPIC, when the user does not already have a section number — e.g. "minimum attic access opening", "ADU setbacks in San Jose". Requires the user's GoCodebook account and uses 1 credit per search (also when nothing is found). If the user already cites a section number, use lookup_california_code_section instead — it is free. Returns ranked excerpts with citations and links. It does NOT decide whether a project complies.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "What to find, in plain words. Up to 300 characters."
},
"jurisdiction": {
"type": "string",
"description": "Optional. A California city or county slug (\"san-jose\", \"marin-county\") to search that place's own code together with the state codes. Omit for statewide."
},
"sources": {
"type": "array",
"items": {
"type": "string",
"enum": [
"federal",
"state",
"local"
]
},
"description": "Optional. Limit to federal law, state codes, or local ordinances."
},
"code_edition": {
"type": "string",
"enum": [
"current",
"2022",
"2019"
],
"description": "Optional. Which Title 24 cycle to search; a permit filed in 2024 is enforced under \"2022\". Defaults to \"current\"."
}
},
"required": [
"query"
]
}출력 스키마
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"found",
"no_results",
"signin_required",
"credits_required",
"rate_limited",
"error"
],
"description": "found / no_results: the search ran and 1 credit was charged (a search with no results still costs a credit). signin_required: the user must connect their GoCodebook account. credits_required: the account has no search credits left; plans_url is an informational page about GoCodebook plans. rate_limited / error: nothing ran and nothing was charged."
},
"query": {
"type": "object",
"properties": {
"query": {
"type": "string"
},
"jurisdiction": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "string",
"enum": [
"federal",
"state",
"local"
]
}
},
"code_edition": {
"type": "string",
"enum": [
"current",
"2022",
"2019"
]
}
},
"required": [
"query",
"jurisdiction",
"code_edition"
]
},
"as_of": {
"type": [
"string",
"null"
]
},
"historical": {
"type": "boolean"
},
"results": {
"type": "array",
"description": "Ranked best-first. Each excerpt is a short passage, never the whole section.",
"items": {
"type": "object",
"properties": {
"document_title": {
"type": "string"
},
"document_slug": {
"type": [
"string",
"null"
]
},
"section_number": {
"type": [
"string",
"null"
]
},
"heading": {
"type": "string"
},
"edition": {
"type": [
"string",
"null"
]
},
"citation": {
"type": "string",
"description": "Cite exactly this string."
},
"source_url": {
"type": [
"string",
"null"
],
"description": "Link to the full section. Always show it."
},
"excerpt": {
"type": "string"
},
"excerpt_truncated": {
"type": "boolean"
}
},
"required": [
"document_title",
"heading",
"citation",
"source_url",
"excerpt",
"excerpt_truncated"
]
}
},
"hint": {
"type": [
"object",
"null"
],
"description": "The search page's own notice about this query (a missing section, a zone code in the wrong city, a code the library does not hold, an address). Tell the user what it says."
},
"section_ref": {
"type": [
"object",
"null"
]
},
"credits_charged": {
"type": "integer"
},
"plans_url": {
"type": [
"string",
"null"
]
},
"message": {
"type": [
"string",
"null"
]
},
"applied_question_url": {
"type": "string"
}
},
"required": [
"status"
]
}커뮤니티
증거