Tlaloc MCP Server

Connect Claude, ChatGPT, and any AI assistant to official Mexican data.

The Tlaloc MCP (Model Context Protocol) server gives AI assistants and agents live, authenticated access to official Mexican data sources: CURP (RENAPO), RFC (SAT), postal codes (SEPOMEX), phone numbers (IFT), SPEI payment receipts / CEP (Banxico), CFDI status (SAT), semantic search over the Diario Oficial de la Federación (DOF), and geocoding with the official Mexican geostatistical framework (INEGI/INE). Pay per call in MXN via SPEI — no credit card, no subscription.

22 read-only tools, one API key. This is a data lookup server — an assistant asks a question and gets an authoritative answer. It is not a KYC/onboarding workflow platform: there are no sessions to create, no state to manage, nothing to write.

Why

• AI-native. Validate a CURP, verify an RFC, search the DOF, or geocode an address straight from your assistant or agent — no glue code.
• Official sources. RENAPO, SAT, SEPOMEX, IFT, Banxico, DOF, INEGI/INE.
• The full Mexican catalog. Identity, tax, addresses, payments, the official gazette and the geostatistical framework — under one tlmx_ API key.
• Fair, transparent pricing. Pay per call, published per tool (below). Prepaid via SPEI, no minimum, no monthly fee.

Quick start

1. Create an account and generate an API key at https://console.tlaloc.sh (keys look like tlmx_...).
2. Add the server to your MCP client:

Claude Code

claude mcp add --transport http tlaloc \
  https://api.tlaloc.sh/mx/mcp \
  --header "Authorization: Bearer tlmx_YOUR_API_KEY"

Claude Desktop / other MCP clients (JSON config)

{
  "mcpServers": {
    "tlaloc": {
      "transport": "http",
      "url": "https://api.tlaloc.sh/mx/mcp",
      "headers": { "Authorization": "Bearer tlmx_YOUR_API_KEY" }
    }
  }
}

• Endpoint: https://api.tlaloc.sh/mx/mcp
• Transport: StreamableHTTP (HTTP)
• Auth: Authorization: Bearer tlmx_YOUR_API_KEY (OAuth is also supported)

More ready-to-run snippets (curl, Python, JavaScript, Claude Desktop config) live in examples/.

Tools

Prices in MXN units (1 unit = $1 MXN, VAT included). Tools marked free cost nothing to call.

Identity — CURP (RENAPO)

Tool	What it does	Price
consultar_curp	Validate a CURP and return its data	0.25
crear_batch_curp	Create a batch of CURP lookups (up to 500)	0.25 / unique item
consultar_batch_curp	Batch summary and progress	free
listar_items_batch_curp	Paginated batch items	free
cancelar_batch_curp	Cancel a running batch	free

Tax — RFC & CFDI (SAT)

Tool	What it does	Price
validar_rfc	Verify an RFC: exists, active, can issue invoices	0.10
estado_cfdi	Check a CFDI's status by UUID (public SAT service)	0.05
consultar_cfdi_sat	Query CFDIs issued/received in the SAT portal (async)	0.30
estado_consulta_cfdi	Poll the result of an async CFDI query	free

Addresses & phones

Tool	What it does	Source	Price
consultar_codigo_postal	Postal code → neighborhoods, city, state	SEPOMEX	0.01
consultar_telefono	Phone number → carrier and portability	IFT	0.01

Payments — SPEI / CEP (Banxico)

Tool	What it does	Price
descargar_cep	Download a SPEI payment receipt (CEP)	0.10
consultar_cep	Verify a SPEI CEP	0.10
listar_instituciones_cep	List the CEP institutions catalog	free

Official gazette — DOF (Diario Oficial de la Federación)

Semantic + keyword search over Mexico's official gazette, 2002–present, with a named entity layer (agencies, NOMs, decrees, people).

Tool	What it does	Price

... View full README on GitHub