GoCodebook — California Building Codes
Verbatim California Title 24 and local zoning code lookup by section number, with citations.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"codes": {
"url": "https://gocodebook.com/api/mcp"
}
}
}Puntos de conexión remotos
https://gocodebook.com/api/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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"
]
}Esquema de salida
{
"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.
Esquema de entrada
{
"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."
}
}
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
]
}Esquema de salida
{
"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"
]
}Comunidad
Evidencia