El servidor MCP conecta un asistente de programación con IA (Claude, Cursor, VS Code y otros clientes MCP) a tu cuenta de MexCheck. Mientras escribe tu integración, el asistente puede leer esta documentación, hacer validaciones reales para ver las respuestas exactas y consultar tu plan y tu saldo.
Es una herramienta para construir la integración, no una parte de ella. En producción tu servidor llama al API REST con una llave API, como describe el resto de esta documentación.
Cómo conectarse
Agrega esta URL a tu asistente como servidor MCP remoto:
https://mexcheck.com/mcp
claude mcp add --transport http mexcheck https://mexcheck.com/mcp
{
"mcpServers": {
"mexcheck": { "url": "https://mexcheck.com/mcp" }
}
}
No hay llave API que pegar. La primera vez que el asistente usa el servidor abre tu navegador, inicias sesión y eliges como qué cuenta actúa: tu cuenta personal o una organización a la que perteneces. Cada conexión actúa como una sola cuenta. Para usar otra, conéctate de nuevo y elígela.
Listar las herramientas y leer la documentación funciona antes de iniciar sesión. El inicio de sesión empieza la primera vez que el asistente usa una herramienta que toca tu cuenta.
Herramientas
| Herramienta | Qué hace |
|---|---|
rfc_validate, rfc_verify, rfc_profile, rfc_find_zip, rfc_sat_lists, cfdi_verify,
csf_verify
|
Los endpoints de RFC, CFDI y Constancia de Situación Fiscal, que responde el SAT. |
curp_lookup, curp_search |
Los endpoints de CURP, que responde RENAPO. |
ine_verify |
El endpoint de credencial para votar, que responde el INE. |
cfe_verify |
El endpoint de recibos de luz, respondido por CFE. |
geo_zip, geo_zip_search |
Los endpoints de códigos postales, respondidos desde el catálogo de Correos de México. |
list_docs, read_doc, get_openapi_operation |
Esta documentación en Markdown, agrupada por producto, y la definición OpenAPI de cada endpoint. |
get_account, list_plans |
El plan de la cuenta conectada, sus créditos usados, su saldo y lo que le cuesta cada validación. |
create_api_key |
Una llave API nueva para tu servidor, que se muestra una sola vez. Las llaves se listan y se revocan en tu panel. |
charge_saved_card |
Agrega saldo con cargo a la tarjeta guardada. Solo si lo permitiste al conectar, hasta tu límite diario. |
create_plan_checkout, create_balance_checkout,
get_billing_portal_link
|
Ligas a páginas de Stripe donde te suscribes, agregas saldo o administras la facturación. |
Cada herramienta de validación recibe los mismos campos que su endpoint REST y devuelve el mismo JSON. La entrega por webhook y /rfc/verify-batch solo están en el API REST, porque una herramienta tiene que responder dentro de la conversación.
Facturación
Una validación hecha por MCP es una consulta real y cuesta los mismos créditos que la llamada REST, del plan y el saldo de la cuenta conectada. Las herramientas de documentación y de cuenta son gratis.
Fuera de eso, las herramientas de facturación solo devuelven una liga: no se cobra nada ni cambia ningún plan hasta que abres la liga y confirmas en la página de Stripe.
La única excepción la decides tú. Al conectar, puedes permitir que el asistente agregue saldo con cargo a la tarjeta guardada de la cuenta, hasta un límite diario que tú fijas ($100 USD si no lo cambias). Está desactivado a menos que marques la casilla, el límite se reinicia a la medianoche UTC, y puedes verlo y terminarlo en Apps conectadas.
Organizaciones
Una conexión a una organización sigue tu rol en ella, igual que el panel. Los administradores y desarrolladores pueden hacer validaciones. Los administradores y los miembros de facturación pueden usar las herramientas de facturación. Un cambio de rol aplica desde la siguiente solicitud, y salir de la organización termina la conexión.
Privacidad
Lo que devuelve una validación (nombres, CURP, datos fiscales) llega al asistente que conectaste y a la empresa que lo opera. Conecta asistentes a los que les confiarías esos datos.
Cómo desconectarse
Abre Llaves API en tu panel. Ahí aparecen las apps conectadas, cada una con un botón Desconectar que termina su acceso de inmediato.