{"openapi":"3.1.0","info":{"title":"Trámite (Procedure) API","version":"0.1.0","description":"A fully local Mexican civic-procedure reference: CURP structure/checksum decoding, RFC basics, and general step/document/agency/time-cost guidance for common trámites (INE, passport, acta de nacimiento, CURP, RFC).\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://tramite.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/tramite/docs"},"termsOfService":"https://connectorbay.com/tramite/terms"},"servers":[{"url":"https://tramite.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/tramite/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/curp_validator":{"post":{"operationId":"curp_validator","summary":"Check whether a CURP is well-formed (structure and check digit) and, if so, decode the birth date, sex","description":"Check whether a CURP is well-formed (structure and check digit) and, if so, decode the birth date, sex\n    and state of birth it encodes. Explains exactly what's wrong when it isn't well-formed. Never confirms the\n    CURP is registered or real — format and checksum only. Use for \"is this CURP valid\", \"what does this CURP\n    decode to\", \"what's wrong with my CURP\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"curp":{"description":"An 18-character CURP.","examples":["GOHJ900515HJCMRN02"],"title":"Curp","type":"string"}},"required":["curp"],"title":"curp_validatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/curp_info":{"post":{"operationId":"curp_info","summary":"What a CURP is, who needs one, and why it exists (population registry / birth registration). Use for","description":"What a CURP is, who needs one, and why it exists (population registry / birth registration). Use for\n    \"what is a CURP\", \"why do I need a CURP\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"curp_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/rfc_info":{"post":{"operationId":"rfc_info","summary":"What an RFC is, its structure basics (name letters, birth date, homoclave), who needs one, and why","description":"What an RFC is, its structure basics (name letters, birth date, homoclave), who needs one, and why\n    (Mexico's tax ID). Use for \"what is an RFC\", \"what does an RFC look like\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"rfc_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/procedure_guide":{"post":{"operationId":"procedure_guide","summary":"A step-by-step overview for a common Mexican trámite — INE voter/photo credential, passport, birth","description":"A step-by-step overview for a common Mexican trámite — INE voter/photo credential, passport, birth\n    certificate (acta de nacimiento), CURP, or RFC registration — with typical required documents and which\n    agency handles it. Use for \"how do I get my INE credential\", \"steps to get a Mexican passport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A trámite name or key.","examples":["ine","pasaporte","acta de nacimiento","curp","rfc"],"title":"Name","type":"string"}},"required":["name"],"title":"procedure_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/document_checklist":{"post":{"operationId":"document_checklist","summary":"The typical documents needed for a given trámite, as a short checklist. Use for \"what do I need to bring","description":"The typical documents needed for a given trámite, as a short checklist. Use for \"what do I need to bring\n    for my INE credential\", \"documents for a Mexican passport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"procedure":{"description":"A trámite name or key.","examples":["ine","pasaporte","acta_nacimiento","curp","rfc"],"title":"Procedure","type":"string"}},"required":["procedure"],"title":"document_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/office_directory_hint":{"post":{"operationId":"office_directory_hint","summary":"Which agency generally handles a given trámite (RENAPO, SAT, INE, SRE, or the state Registro Civil) and","description":"Which agency generally handles a given trámite (RENAPO, SAT, INE, SRE, or the state Registro Civil) and\n    where to go — informational only, not a live office directory or lookup. Use for \"who issues passports in\n    Mexico\", \"which agency handles the CURP\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"procedure":{"description":"A trámite name/key, or an agency name (RENAPO, SAT, INE, SRE).","examples":["ine","pasaporte","rfc","SAT"],"title":"Procedure","type":"string"}},"required":["procedure"],"title":"office_directory_hintArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/estimated_time_cost":{"post":{"operationId":"estimated_time_cost","summary":"A typical processing-time range and fee tier (free / nominal / moderate) for a trámite — heavily","description":"A typical processing-time range and fee tier (free / nominal / moderate) for a trámite — heavily\n    caveated, since exact figures change and vary by state and office. Use for \"how long does an INE credential\n    take\", \"is there a fee for the CURP\", \"how much does a Mexican passport cost\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"procedure":{"description":"A trámite name or key.","examples":["ine","pasaporte","acta_nacimiento","curp","rfc"],"title":"Procedure","type":"string"}},"required":["procedure"],"title":"estimated_time_costArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/required_documents":{"post":{"operationId":"required_documents","summary":"A deeper look at the documents a trámite needs — each item with a note on what it's for or how to get","description":"A deeper look at the documents a trámite needs — each item with a note on what it's for or how to get\n    it — plus which agency handles it and where to go. Use for \"what exactly counts as proof of address for the\n    INE\", \"what document proves Mexican nationality for a passport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"procedure":{"description":"A trámite name or key.","examples":["ine","pasaporte","acta_nacimiento","curp","rfc"],"title":"Procedure","type":"string"}},"required":["procedure"],"title":"required_documentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/procedure_glossary":{"post":{"operationId":"procedure_glossary","summary":"Definitions of common Mexican civic-procedure terms (CURP, RFC, homoclave, acta, credencial, trámite,","description":"Definitions of common Mexican civic-procedure terms (CURP, RFC, homoclave, acta, credencial, trámite,\n    cita, comprobante de domicilio, vigencia, constancia). Use for \"what does homoclave mean\", \"what's a\n    comprobante de domicilio\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"procedure_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}