# Tlaloc Web Services

> APIs profesionales para validación de datos oficiales mexicanos: CURP (RENAPO), RFC (SAT), códigos postales (SEPOMEX), números telefónicos (IFT) y comprobantes de pago SPEI/CEP (Banxico), más búsqueda semántica del Diario Oficial de la Federación (DOF). Modelo de prepago, pago por consulta vía SPEI (sin tarjeta, sin suscripción). Incluye un servidor MCP para conectar asistentes de IA (Claude, ChatGPT) con datos oficiales de México.

## Servidor MCP (Model Context Protocol)

Servidor MCP de **consulta directa** de datos oficiales mexicanos: el agente pregunta y recibe una respuesta autoritativa. **No es una plataforma de flujos KYC/onboarding** — no hay sesiones que crear ni estado que administrar. Cubre el catálogo mexicano completo: identidad (CURP/RENAPO), fiscal (RFC y CFDI ante el SAT), direcciones (SEPOMEX), telefonía (IFT), pagos SPEI (CEP/Banxico), el Diario Oficial de la Federación y el marco geográfico oficial (INEGI/INE).

- URL: https://api.tlaloc.sh/mx/mcp
- Transporte: HTTP (StreamableHTTP)
- Autenticación: header `Authorization: Bearer tlmx_TU_API_KEY` (también compatible con OAuth)
- Alta en Claude Code: `claude mcp add --transport http tlaloc https://api.tlaloc.sh/mx/mcp --header "Authorization: Bearer tlmx_TU_API_KEY"`
- Herramientas documentadas:
  - Identidad (CURP/RENAPO): consultar_curp, crear_batch_curp, consultar_batch_curp,
    listar_items_batch_curp, cancelar_batch_curp
  - Fiscal (SAT): validar_rfc, estado_cfdi, consultar_cfdi_sat, estado_consulta_cfdi
  - Direcciones y teléfonos: consultar_codigo_postal, consultar_telefono
  - Pagos SPEI (Banxico): descargar_cep, consultar_cep, listar_instituciones_cep
  - Diario Oficial (DOF): buscar_dof, buscar_subsecciones_dof, buscar_entidades_dof,
    unidades_por_entidad_dof, obtener_documento_dof, indice_ejemplar_dof
  - Geo (INEGI/INE): geocodificar_direccion, consultar_marco_geografico

## Servicios API

- [CURP](https://www.tlaloc.sh/es/services/curp.html): Validación de CURP ante RENAPO. $0.25 MXN por consulta.
- [RFC](https://www.tlaloc.sh/es/services/rfc.html): Verificación de RFC ante el SAT. $0.10 MXN por consulta.
- [Códigos Postales](https://www.tlaloc.sh/es/services/postal.html): Consulta de códigos postales de SEPOMEX. $0.01 MXN por consulta.
- [Números Telefónicos](https://www.tlaloc.sh/es/services/phone.html): Consulta de números telefónicos del IFT. $0.01 MXN por consulta.
- [CEP](https://www.tlaloc.sh/es/services/cep.html): Descarga y verificación de Comprobantes Electrónicos de Pago SPEI de Banxico. $0.10 MXN por consulta.
- [DOF — Diario Oficial de la Federación](https://www.tlaloc.sh/es/services/dof.html): Búsqueda semántica y por palabras clave sobre el Diario Oficial de la Federación (2002 al presente): publicaciones, entidades (dependencias, NOM, decretos) y texto completo. Desde $0.05 MXN por consulta.
- [Geocodificación y marco geográfico](https://www.tlaloc.sh/es/services/geo.html): Dirección mexicana → coordenadas (mediana 14–17 m en hold-outs limpios) y marco geográfico oficial (estado, municipio, AGEB, manzana, código postal y colonia oficial de polígonos INE). Datos abiertos INEGI/INE/Overture; las direcciones consultadas nunca se guardan. Desde $0.01 MXN por consulta.
- [Consulta de CFDI](https://api.tlaloc.sh/mx/docs): Consulta y validación de comprobantes fiscales ante el SAT — estado de un CFDI por UUID ($0.05 MXN) y consulta de CFDIs emitidos o recibidos ($0.30 MXN). Solo lectura: no generamos ni timbramos comprobantes.

## Precios

Modelo prepagado por unidades. 1 unidad = $1 MXN (IVA incluido). Pago vía SPEI, sin tarjeta, sin monto mínimo y sin suscripción.

| Operación | Costo |
|-----------|-------|
| Código postal | 0.01 u |
| Teléfono | 0.01 u |
| RFC | 0.10 u |
| CEP consulta | 0.10 u |
| CEP descarga | 0.10 u |
| CURP | 0.25 u |
| Estado de CFDI (SAT) | 0.05 u |
| Consulta de CFDIs (SAT) | 0.30 u |
| DOF búsqueda | 0.05 u |
| DOF entidades | 0.05 u |
| DOF documento | 0.10 u |
| DOF documento con anotaciones (NER) | 1.00 u |
| DOF índice de ejemplar | 0.10 u |
| Geocodificación | 0.05 u |
| Marco Geográfico (reverse) | 0.02 u |
| CP → Polígono | 0.01 u |

## Enlaces

- [Documentación API](https://api.tlaloc.sh/mx/docs): Especificación OpenAPI/Swagger
- [Precios](https://www.tlaloc.sh/es/pricing.html): Detalle de precios por servicio
- [Consola](https://console.tlaloc.sh): Alta de cuenta, API keys y saldo
- [Blog](https://www.tlaloc.sh/es/blog/): Guías técnicas y tutoriales
- [Referencia completa (llms-full.txt)](https://www.tlaloc.sh/llms-full.txt): Referencia técnica de la API para asistentes de IA.

## Contacto

- Email: hello@tlaloc.sh
- Sitio web: https://www.tlaloc.sh

---

## English

> Professional APIs for validating official Mexican data: CURP (RENAPO), RFC (SAT), postal codes (SEPOMEX), phone numbers (IFT), and SPEI payment receipts / CEP (Banxico), plus semantic search over Mexico's official gazette (Diario Oficial de la Federación, DOF). Prepaid, pay-per-call via SPEI bank transfer (no credit card, no subscription). Includes an MCP server to connect AI assistants (Claude, ChatGPT) to official Mexican data.

### MCP server

A **direct data-lookup** MCP server for official Mexican data: the agent asks, and gets an authoritative answer. **It is not a KYC/onboarding workflow platform** — no sessions to create, no state to manage. It covers the full Mexican catalog: identity (CURP/RENAPO), tax (RFC and CFDI status at SAT), addresses (SEPOMEX), telecom (IFT), SPEI payments (CEP/Banxico), the Diario Oficial de la Federación, and the official geostatistical framework (INEGI/INE).

- URL: https://api.tlaloc.sh/mx/mcp — Transport: StreamableHTTP (HTTP)
- Auth: `Authorization: Bearer tlmx_YOUR_API_KEY` (OAuth also supported)
- Add in Claude Code: `claude mcp add --transport http tlaloc https://api.tlaloc.sh/mx/mcp --header "Authorization: Bearer tlmx_YOUR_API_KEY"`
- Tools: consultar_curp, crear_batch_curp, consultar_batch_curp, listar_items_batch_curp,
  cancelar_batch_curp, validar_rfc, estado_cfdi, consultar_cfdi_sat, estado_consulta_cfdi,
  consultar_codigo_postal, consultar_telefono, descargar_cep, consultar_cep,
  listar_instituciones_cep, buscar_dof, buscar_subsecciones_dof, buscar_entidades_dof,
  unidades_por_entidad_dof, obtener_documento_dof, indice_ejemplar_dof,
  geocodificar_direccion, consultar_marco_geografico.

### Services & pricing

Prepaid units, 1 unit = $1 MXN (VAT incl.), paid via SPEI:

- CURP validation (RENAPO) — $0.25
- RFC verification (SAT) — $0.10
- Postal codes (SEPOMEX) — $0.01
- Phone numbers (IFT) — $0.01
- SPEI receipt / CEP (Banxico), query or download — $0.10
- DOF — Diario Oficial de la Federación (Mexico's official gazette) semantic + keyword search — from $0.05
- Geocoding + official geographic framework (INEGI/INE) — geocode $0.05, reverse $0.02, postal-code polygon $0.01. Queried addresses are never stored. Details: https://www.tlaloc.sh/en/services/geo.html
- CFDI verification with SAT — status by UUID $0.05, async query of sent or received CFDIs $0.30. Read-only lookup of existing receipts.

### Links

- API docs: https://api.tlaloc.sh/mx/docs
- Console (get an API key): https://console.tlaloc.sh
- Website: https://www.tlaloc.sh
- Full reference (llms-full.txt): https://www.tlaloc.sh/llms-full.txt