Skills_MX / website

# Plugins MX — Plugins de Claude Code, skills y MCPs para México

**Versión completa para LLM ingest. Última actualización: 2026-10-14.**
**Autor:** Elías Rashid Morales Mendoza — Ciudad de México.
**Sitio:** https://skills-mexico.vercel.app · **Repo:** https://github.com/elimorals/Skills_MX (el README raíz es la fuente de verdad)
**Licencia:** Apache-2.0 · **Contacto:** elimoralsmendox@gmail.com

---

## Qué es Plugins MX

Plugins de Claude Code, skills y MCP servers para operar una PyME o profesión en México: CFDI 4.0, SAT, nómina e IMSS, pagos, marketplaces, trámites estatales y municipales, y 40 verticales por industria.

| | |
|---|---|
| Plugins verticales | 40, cada uno con sus skills, comandos, agentes y MCPs |
| Skills | 342 (6 base en `_shared/` sincronizadas a cada plugin) |
| MCP servers | 83 en Python + FastMCP, 417 tools |
| Workflows ejecutables | 26 (`*.workflow.js`) |
| Hooks de Claude Code | 17 scripts, 12 registrados en `.claude/settings.json` (validación de timbrado, bitácora, alertas) |
| Webhook receiver | FastAPI con 12 handlers (Stripe, Mercado Pago, Conekta, Facturama, WhatsApp…) |
| Calidad | 1,900 tests, 285 evals de triggering, casos golden de cálculo fiscal, CI en cada PR |

Cómo se conectan las piezas: una skill sabe qué hacer (reglas fiscales, plantillas, flujos); un MCP hace la consulta real (SAT, Banxico, municipios, pasarelas); un workflow orquesta varias skills y MCPs para un proceso completo; los hooks validan antes de acciones sensibles, como timbrar o enviar WhatsApp masivo.

**Regla común:** ningún MCP devuelve datos simulados haciéndolos pasar por reales. Sin credenciales responde datos de ejemplo marcados `simulated: true`; con credenciales, cualquier error del proveedor se propaga como error tipado (`AuthError`, `UpstreamError`, `NotFoundError`…). `PLUGINS_MX_MOCK=1` fuerza el modo de ejemplo.

---

## Instalación

### Plugins en Claude Code
```bash
/plugin marketplace add elimorals/Skills_MX
/plugin install core-mexico --marketplace elimorals/Skills_MX      # base de todos los verticales
/plugin install freelancers-mx --marketplace elimorals/Skills_MX   # o cualquier vertical
```
`core-mexico` (CFDI, IVA y retenciones, RFC, MXN, LFPDPPP, WhatsApp) es la dependencia de todos los verticales. Los MCPs de cada plugin se descargan solos la primera vez con uv (https://docs.astral.sh/uv/), el único requisito además de Claude Code.

### MCP suelto
Cada MCP trae un `example.mcp.json` listo para copiar; no depende de dónde esté el repo. Ejemplo, portal del SAT:
```json
{
  "mcpServers": {
    "sat_portal": {
      "command": "uv",
      "args": ["run", "--no-project", "--quiet", "--with",
               "plugins-mx-mcp-servers[sat-ws,sat-portal] @ git+https://github.com/elimorals/Skills_MX@main#subdirectory=mcp-servers",
               "python", "-m", "mp_sat_portal.server"],
      "env": {
        "SAT_RFC": "${SAT_RFC:-}",
        "SAT_EFIRMA_CERT": "${SAT_EFIRMA_CERT:-}",
        "SAT_EFIRMA_KEY": "${SAT_EFIRMA_KEY:-}",
        "SAT_EFIRMA_PASSWORD": "${SAT_EFIRMA_PASSWORD:-}"
      }
    }
  }
}
```
Las credenciales van en variables de entorno, nunca en el repo (`.env.example` las lista todas).

---

## Plugins verticales (40, por sector)

- **Base:** core-mexico
- **Fiscal y contable:** pf-anual-mx (declaración anual PF) · despacho-contable-mx (contabilidad multi-cliente) · nomina-pymes-mx (nómina, IMSS-IDSE, INFONAVIT) · cripto-fiscal-mx (ISR de cripto) · donatarias-ongs-mx (CFDI de donativos, transparencia) · sucesion-empresa-familiar-mx (patrimonio y sucesión) · crowdfunding-itf-mx (inversionistas en IFC)
- **Comercio:** ecommerce-mx (Mercado Libre, Shopify, Amazon) · tienda-omnicanal-mx (inventario multicanal) · restaurante-mx (restaurantes, dark kitchens, delivery) · importadores-mx (IGI, DTA, pedimentos) · agencia-marketing-mx (reportes y copy para clientes)
- **Servicios profesionales:** freelancers-mx (cotizaciones, honorarios, RESICO) · despacho-legal-mx (honorarios y contratos) · notarias-mx (citas, escrituras) · agente-seguros-mx (cartera de pólizas, CNSF)
- **Salud:** clinica-salud-mx · consultorio-especialista-mx · telemedicina-mx · psicoterapia-mx · laboratorio-clinico-mx · geriatria-cuidado-mayor-mx · veterinaria-mx · paciente-mx · gmm-asegurado-mx
- **Inmobiliario y construcción:** inmobiliaria-mx (corredores) · arrendador-residencial-mx (rentas PF) · airbnb-host-mx (renta corta, ISH) · constructora-mx (obra, REPSE)
- **Educación:** colegios-mx (K-12, colegiaturas deducibles) · educacion-particular-b2c-mx (cursos en línea)
- **Servicios personales y eventos:** salon-mx (salones, spas, barberías) · wedding-mx (wedding planners) · talleres-mx (talleres mecánicos)
- **Vehículos y movilidad:** tramites-vehiculares-mx (tenencia, verificación, multas) · conductor-plataforma-mx (Uber, DiDi, Cabify)
- **Hogar, energía y trámites:** servicios-publicos-mx (CFE, agua, predial, gas) · energia-solar-pyme-mx (interconexión CFE) · migracion-extranjeros-mx (trámites INM)

### Workflows ejecutables (26)

| Plugin | Workflows |
|---|---|
| core-mexico | cfdi-emision-completa · emitir-cfdi-tras-pago · pago-conciliacion · cierre-fiscal-mensual · auditoria-fiscal-mensual · declaracion-resico-mensual · due-diligence-cliente · validacion-cfdis-historico |
| freelancers-mx | cobranza-multinivel · migracion-rfc-a-otro-regimen |
| inmobiliaria-mx | cobranza-renta-mensual · cartera-predial-multi-municipio |
| cripto-fiscal-mx | declaracion-anual-cripto · cripto-cierre-anual |
| agencia-marketing-mx | reporte-cliente-agencia · respuesta-crisis-cm |
| Otros | pf-anual-completa · dispersion-nomina · sync-multicanal · comunicacion-padres-masiva · garantia-vehicular · monitoreo-diario-vehicular · telemedicina-consulta · donativo-anual · pedimento-importacion · energia-bidireccional-mensual |

---

## MCP servers por fuente

| Grupo | MCPs | Cómo obtienen el dato |
|---|---|---|
| SAT | sat_ws, sat_portal, sat_opinion_32d, resico_sat, donatarias_sat | Web service de Descarga Masiva (XMLDSig), ConsultaCFDIService, login con e.firma por HTTP, listas 69/69-B y padrón de donatarias oficiales |
| Federales | banxico, banxico_cep, clabe_validador_oficial, repse_stps, condusef_sipres, dof_api, cnbv_fintech, impi_marcanet, conagua_repda, cre_hidrocarburos, concilianet_profeco, llave_mx, retys_catalogo y más | API o endpoint público detrás de cada portal |
| Con CAPTCHA | curp_renapo, repuve, sep_profesional, ine_verificacion | Entrega a humano o solver opt-in |
| Estatal y municipal | cdmx_municipal, edomex_municipal, queretaro_municipal, monterrey_municipal, guadalajara_municipal, puebla_municipal, predial_mx, agua_mx, gas_natural_mx, multas_mx, tenencia_mx, isn_mx, ish_mx… | Consulta pública por cuenta o placa; tasas citadas a la ley estatal 2026 |
| APIs privadas | mercado_pago, conekta, mercado_libre, shopify_mx, amazon_mx_seller, paypal_mx, clip_terminal, cabify_business, rappi_partners, facturama_extendido, bitso | Cliente contra la documentación oficial de cada proveedor |
| Cumplimiento normativo | ley_silla_nom037, desconexion_digital, expediente_clinico_nom024, cfe_interconexion_solar, lnetb_auditor | Cálculo local con fundamento legal citado |
| Pendientes (login de usuario) | imss_patronal, infonavit_patronal, bancos_mx, buro_credito_personal, cfe_facturacion, telmex_facturacion | Requieren credenciales de prueba y captura del flujo |

Significado de cada estado: "Real, validado en vivo" = consulta el portal o API oficial y se probó en vivo; "Real sin validar" = cliente escrito contra la documentación oficial, falta una credencial; "Entrega a humano" = el portal exige CAPTCHA o login y el tool devuelve URL, pasos y campos prellenados; "Sin API pública" = el proveedor no ofrece API y el tool responde un error explícito; "Cálculo normativo" = cálculo local con tasas y reglas citadas a su fuente; "Bloqueado / sin verificar" = portal caído o sin fuente pública / aún sin la revisión de la oleada 1.

<!-- estado-mcps:inicio -->
### Estado a 2026-10-14 (oleada 1: mock → real)

Generado por `scripts/generar-estado-mcps.py` desde la sección "Estado real" de cada README. 83 MCPs, 417 tools.

| Categoría | MCPs |
|---|---|
| Real, validado en vivo | 24 |
| Real sin validar (requiere credenciales) | 13 |
| Entrega a humano (CAPTCHA o login) | 17 |
| Sin API pública | 6 |
| Cálculo normativo verificado | 10 |
| Bloqueado | 2 |
| Sin verificar | 11 |

| MCP | Estado | Nota | Tools |
|---|---|---|---|
| `mp_agua_mx` | Real, validado en vivo | Parcial: JMAS Juárez real; SIAPA con reCAPTCHA; CESPT da 404; OOAPAS sin parser validado. | `agua_consultar_adeudo`, `agua_listar_organismos`, `agua_buscar_por_estado`, `agua_estadisticas` |
| `mp_amazon_mx_seller` | Real sin validar (requiere credenciales) | Rutas SP-API verificadas (Orders, Listings, Fees); falta una app SP-API autorizada. | `amazon_mx_list_listings`, `amazon_mx_get_listing`, `amazon_mx_update_inventory`, `amazon_mx_list_orders`, `amazon_mx_get_order`, `amazon_mx_get_fees_estimate`, `amazon_mx_listar_catalogos` |
| `mp_aspel_contpaqi` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `aspel_listar_polizas`, `aspel_get_poliza`, `aspel_obtener_balanza`, `aspel_obtener_catalogo_cuentas`, `aspel_obtener_estado_resultados`, `aspel_obtener_balance_general`, `aspel_parsear_export_csv`, `aspel_obtener_instrucciones_configuracion`, `aspel_listar_catalogos` |
| `mp_bancos_mx` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `bancos_listar_soportados`, `bancos_descargar_estado_cuenta`, `bancos_listar_movimientos`, `bancos_verificar_pago_por_referencia` |
| `mp_banxico` | Real sin validar (requiere credenciales) | SIE API v1 real; requiere BANXICO_TOKEN gratuito. Mock usa UMA 2026 = 117.31. | `banxico_get_tc_dof`, `banxico_get_tc_dia_habil_anterior`, `banxico_convertir_monto`, `banxico_get_uma`, `banxico_get_inpc`, `banxico_get_tiie_28`, `banxico_listar_monedas_soportadas` |
| `mp_banxico_cep` | Real, validado en vivo | Consulta de estado y 'no encontrado' validadas; descarga de un SPEI existente sin validar. Handoff si vuelve el CAPTCHA. | `banxico_cep_validar_clabe`, `banxico_cep_decodificar_clabe`, `banxico_cep_parsear_clave_rastreo`, `banxico_cep_lookup_banco`, `banxico_cep_generar_cep`, `banxico_cep_validar_cep`, `banxico_cep_descargar_pdf`, `banxico_cep_consultar_pago_por_clave`, `banxico_cep_listar_bancos`, `banxico_cep_listar_catalogos` |
| `mp_bitso` | Real, validado en vivo | Ticker, order book y pares públicos validados en vivo sin llaves (2026-10-14); endpoints privados requieren BITSO_API_KEY/SECRET. | `bitso_get_ticker`, `bitso_get_order_book`, `bitso_list_available_books`, `bitso_get_account_status`, `bitso_get_balance`, `bitso_get_fees`, `bitso_get_ledger`, `bitso_list_fundings`, `bitso_list_withdrawals`, `bitso_list_open_orders`, `bitso_calcular_isr_cripto_mx`, `bitso_listar_catalogos` |
| `mp_buro_credito_personal` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `buro_consultar_score`, `buro_descargar_reporte_completo`, `buro_monitorear_alertas`, `buro_listar_catalogos` |
| `mp_cabify_business` | Real sin validar (requiere credenciales) | Reescrito contra la API oficial v4 (estimates, journey, sales); falta sandbox. Sin listado de viajes ni CFDI. | `cabify_estimar`, `cabify_pedir_viaje`, `cabify_consultar_viaje`, `cabify_estado_viaje`, `cabify_cancelar_viaje`, `cabify_ventas_viaje`, `cabify_listar_catalogos` |
| `mp_catastro_estatal_mx` | Entrega a humano (CAPTCHA o login) | IGECEM: handoff; IRCEP sin DNS; IRCNL y OVICA exigen login. | `catastro_consultar_valor`, `catastro_listar_sistemas` |
| `mp_cdmx_municipal` | Entrega a humano (CAPTCHA o login) | Predial (ALTCHA) y tenencia/multas (CAPTCHA de imagen): handoff. Hoy No Circula: cálculo local. Con solver opt-in (2captcha): consulta real, sin validar en vivo (falta llave). | `cdmx_consultar_predial`, `cdmx_consultar_tenencia`, `cdmx_consultar_multas`, `cdmx_consultar_hoy_no_circula`, `cdmx_listar_catalogos` |
| `mp_cfe_facturacion` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `cfe_descargar_factura_mes`, `cfe_consumo_historico`, `cfe_validar_session` |
| `mp_cfe_interconexion_solar` | Cálculo normativo verificado | Umbrales de la LSE (DOF 18-03-2025); sin tarifas ni folios inventados. | `cfe_solar_solicitar`, `cfe_solar_estatus`, `cfe_solar_simular_ahorro`, `cfe_solar_listar_tarifas` |
| `mp_citas_monitor` | Entrega a humano (CAPTCHA o login) | SAT exige sesión, SRE tiene Radware Captcha, IMSS sin DNS, INE informativo. No reserva citas. | `citas_listar_portales`, `citas_generar_consent_token`, `citas_crear_alerta`, `citas_revisar_cupos`, `citas_estadisticas_eticas` |
| `mp_clabe_validador_oficial` | Real, validado en vivo | Catálogo SPEI de Banxico validado en vivo. | `clabe_validador_validar_clabe`, `clabe_validador_info_banco_clabe` |
| `mp_clip_terminal` | Real sin validar (requiere credenciales) | Reescrito contra developer.clip.mx (payments, refunds, devices, settlements); falta credencial de pruebas. | `clip_list_charges`, `clip_get_charge`, `clip_refund_charge`, `clip_terminal_status`, `clip_get_settlement`, `clip_listar_catalogos` |
| `mp_cnbv_fintech` | Real, validado en vivo | Padrón PES de la CNBV validado; no publica RFC; sin fuente para modelos novedosos. | `cnbv_fintech_consultar_itf`, `cnbv_fintech_listar_ifpe`, `cnbv_fintech_listar_ifc`, `cnbv_fintech_listar_modelos_novedosos`, `cnbv_fintech_verificar_contraparte` |
| `mp_cofepris_aviso_funcionamiento` | Cálculo normativo verificado | Constantes de la LGS (reforma DOF 15-01-2026); giros por Acuerdo SSA sin cotejar. | `cofepris_clasificar_giro`, `cofepris_requisitos_aviso`, `cofepris_consultar_aviso`, `cofepris_listar_giros` |
| `mp_conagua_repda` | Real, validado en vivo | Consulta REPDA (ASP.NET, sin CAPTCHA) validada en vivo. | `repda_consultar_titular`, `repda_estado_reporte`, `repda_calcular_lfd`, `repda_vigencia`, `repda_requiere_medidor`, `repda_listar_tipos_uso` |
| `mp_concilianet_profeco` | Real, validado en vivo | PDFs de Concilianet y Buró Comercial validados en vivo. | `concilianet_consultar_proveedor`, `concilianet_buro_quejas`, `concilianet_estatus_caso`, `concilianet_listar_proveedores`, `concilianet_registrar_queja` |
| `mp_condusef_sipres` | Real, validado en vivo | SIPRES validado en vivo (requiere extra truststore por TLS incompleto). | `sipres_buscar_institucion`, `sipres_verificar_autorizada` |
| `mp_conekta` | Real sin validar (requiere credenciales) | Rutas API 2.1.0 coinciden con la doc oficial; falta llave sandbox. | `conekta_create_order`, `conekta_get_order`, `conekta_list_orders`, `conekta_create_charge_on_order`, `conekta_refund_order`, `conekta_create_customer`, `conekta_get_customer`, `conekta_create_payment_link`, `conekta_subscription_create`, `conekta_subscription_update`, `conekta_subscription_cancel`, `conekta_validate_webhook`, `conekta_listar_catalogos` |
| `mp_cre_hidrocarburos` | Real, validado en vivo | XML público de precios/permisos (15,046 estaciones) validado en vivo. | `cre_consultar_permiso`, `cre_calendar_reporte`, `cre_evaluar_anexo30`, `cre_reportar_zeros`, `cre_listar_tipos_permiso` |
| `mp_curp_renapo` | Entrega a humano (CAPTCHA o login) | gob.mx/curp con challenge Akamai y reCAPTCHA Enterprise; validación local de la CURP. Solver opt-in conectado, pero hoy bloquea un anti-bot de red antes del captcha (CURP: Akamai; INE: Cloudflare) y queda en handoff. | `curp_validar_estructura`, `curp_derivar_fecha_nacimiento`, `curp_derivar_sexo`, `curp_derivar_estado`, `curp_validar_lote`, `curp_generar_desde_datos`, `curp_consultar_renapo`, `curp_consultar_renapo_por_datos`, `curp_descargar_constancia_renapo`, `curp_listar_catalogos` |
| `mp_desconexion_digital` | Cálculo normativo verificado | LFT vigente: desconexión solo en teletrabajo (Art. 330-E); no existe la 'reforma Art. 132 marzo 2026'. | `desconexion_checklist`, `desconexion_generar_politica`, `desconexion_template_capacitacion` |
| `mp_didi_food_partners` | Sin API pública | DiDi Food no publica API de comercios; con credenciales devuelve ConfigError. | `didi_food_listar_ordenes`, `didi_food_consultar_orden`, `didi_food_listar_productos_menu`, `didi_food_actualizar_disponibilidad`, `didi_food_consultar_ranking_zona`, `didi_food_estimar_comisiones_mes` |
| `mp_didi_partners` | Sin API pública | DiDi no publica API para conductores; con credenciales devuelve ConfigError. | `didi_partners_listar_viajes`, `didi_partners_consultar_viaje`, `didi_partners_comisiones_mes` |
| `mp_dof_api` | Real, validado en vivo | API JSON de SIDOF validada; búsqueda por título recorriendo sumarios diarios. | `dof_sumario_dia`, `dof_buscar_texto`, `dof_detalle_nota`, `dof_monitorear_por_keyword`, `dof_listar_dependencias_comunes` |
| `mp_donatarias_sat` | Real, validado en vivo | Directorio XLSX del SAT validado (10,017 RFC); no incluye revocaciones posteriores al corte. | `donatarias_consultar`, `donatarias_buscar`, `donatarias_listar_por_entidad`, `donatarias_estadisticas`, `donatarias_listar_rubros` |
| `mp_edomex_municipal` | Real, validado en vivo | Parcial: predial Toluca real; tenencia y multas handoff; Ecatepec, Naucalpan e Izcalli fallan. | `edomex_consultar_predial`, `edomex_consultar_tenencia`, `edomex_consultar_multas`, `edomex_listar_catalogos` |
| `mp_expediente_clinico_nom024` | Cálculo normativo verificado | NOM-024, NOM-004 y LGS verificadas; Reglamento de Insumos sin cotejar. | `ece_generar_receta`, `ece_verificar_medico`, `ece_validar_sistema`, `ece_consentimiento_paciente` |
| `mp_facturama_extendido` | Real sin validar (requiere credenciales) | Rutas verificadas contra el cliente de satcfdi; falta cuenta sandbox. | `facturama_validar_payload_local`, `facturama_timbrar_cfdi`, `facturama_cancelar_cfdi`, `facturama_consultar_estatus`, `facturama_descargar_xml`, `facturama_descargar_pdf`, `facturama_buscar_cfdis`, `facturama_listar_catalogos` |
| `mp_form_filler_public` | Entrega a humano (CAPTCHA o login) | Ya no abre navegador ni envía formularios: devuelve URL, pasos y campos prellenados. | `form_listar_formularios`, `form_validar_inputs`, `form_llenar` |
| `mp_gas_natural_mx` | Real, validado en vivo | Parcial: tarifas Ecogas (PDF) validadas; otros distribuidores sin fuente → upstream_error. | `gas_consultar_recibo`, `gas_tarifas_vigentes`, `gas_listar_distribuidores` |
| `mp_guadalajara_municipal` | Entrega a humano (CAPTCHA o login) | Predial y adeudos vehiculares con reCAPTCHA. Con solver opt-in (2captcha): consulta real, sin validar en vivo (falta llave). | `guadalajara_mun_consultar_predial`, `guadalajara_mun_consultar_multas` |
| `mp_impi_marcanet` | Real, validado en vivo | MARCia (IMPI) validado en vivo, sin CAPTCHA ni login. | `impi_buscar`, `impi_verificar_denominacion` |
| `mp_imss_continuidad` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `imss_continuidad_listar_sistemas`, `imss_continuidad_health_check`, `imss_continuidad_plan`, `imss_continuidad_reporte_ejecutivo` |
| `mp_imss_patronal` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `imss_consultar_avisos_pendientes`, `imss_enviar_movimiento_afiliatorio`, `imss_descargar_cedula_autodeterminacion`, `imss_consultar_emcr`, `imss_consultar_sbc`, `imss_consultar_padron_trabajadores`, `imss_sbc_calcular`, `imss_ema_vs_eba_diferencias`, `imss_calendario_obligaciones`, `imss_simulador_costo_patronal`, `imss_riesgo_trabajo_prima_cambio`, `imss_listar_catalogos` |
| `mp_ine_verificacion` | Entrega a humano (CAPTCHA o login) | Lista nominal con Cloudflare y reCAPTCHA v2; no se evade. Solver opt-in conectado, pero hoy bloquea un anti-bot de red antes del captcha (CURP: Akamai; INE: Cloudflare) y queda en handoff. | `ine_verificar_datos`, `ine_verificar_qr`, `ine_consultar_vigencia`, `ine_generar_autorizacion`, `ine_listar_modelos` |
| `mp_infonavit_patronal` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `infonavit_consultar_creditos_trabajadores`, `infonavit_descargar_emis`, `infonavit_consultar_descuentos_mensuales`, `infonavit_consultar_avisos_pendientes`, `infonavit_descuento_calcular`, `infonavit_creditos_sin_reporte`, `infonavit_emis_historico`, `infonavit_conciliacion_nomina`, `infonavit_listar_catalogos` |
| `mp_inmuebles24` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `inm24_buscar_inmuebles`, `inm24_obtener_detalle`, `inm24_buscar_comparables_zona`, `inm24_publicar_listing`, `inm24_listar_catalogos` |
| `mp_ish_mx` | Cálculo normativo verificado | Cálculo local; tasas 2026 contra fuentes secundarias (confianza media, varias en conflicto). | `ish_calcular`, `ish_info_estado`, `ish_listar_estados`, `ish_comparar_estados` |
| `mp_isn_mx` | Cálculo normativo verificado | Cálculo local; tasas 2026 contra fuente secundaria. | `isn_calcular`, `isn_listar_estados`, `isn_info_estado`, `isn_generar_linea_captura`, `isn_descargar_declaracion` |
| `mp_klap` | Sin API pública | Sin documentación pública de API; con credenciales devuelve ConfigError. | `klap_listar_pagos`, `klap_consultar_pago` |
| `mp_kueski` | Sin API pública | API solo para comercios afiliados; con credenciales devuelve ConfigError. | `kueski_listar_pagos`, `kueski_consultar_pago`, `kueski_cancelar_pago` |
| `mp_ley_silla_nom037` | Cálculo normativo verificado | LFT (Ley Silla DOF 19-12-2024), NOM-035, NOM-037 y UMA 2026 verificadas. | `silla_verificar_compliance`, `silla_calcular_multa`, `silla_generar_politica`, `silla_listar_obligaciones` |
| `mp_llave_mx` | Real sin validar (requiere credenciales) | Login con CAPTCHA; el canje de token requiere convenio con la ATDT. Estadísticas de adopción leídas de datos.gob.mx. | `llave_iniciar_oauth`, `llave_estado_endpoints`, `llave_estadisticas_adopcion`, `llave_validar_token`, `llave_listar_tramites`, `llave_detalle_tramite`, `llave_vincular_e_firma` |
| `mp_llave_mx_tracker` | Real, validado en vivo | Revisión de portadas de 20 portales validada en vivo; solo mira la portada. | `llave_mx_listar_dependencias`, `llave_mx_estatus_dependencia`, `llave_mx_estadisticas_nacionales`, `llave_mx_verificar_en_vivo` |
| `mp_lnetb_auditor` | Cálculo normativo verificado | Plazos de los transitorios de la LNETB (DOF 16-07-2025); se retiraron scores por estado sin fuente. | `lnetb_listar_indicadores`, `lnetb_plazos_legales`, `lnetb_evaluar_estado`, `lnetb_ranking_nacional`, `lnetb_comparar_estados` |
| `mp_mercado_libre` | Real sin validar (requiere credenciales) | Rutas cotejadas; reputación corregida a GET /users/{id} → seller_reputation. Falta app OAuth. | `mercadolibre_get_me`, `mercadolibre_list_items`, `mercadolibre_get_item`, `mercadolibre_update_stock`, `mercadolibre_update_price`, `mercadolibre_pause_item`, `mercadolibre_activate_item`, `mercadolibre_list_orders`, `mercadolibre_get_order`, `mercadolibre_list_messages`, `mercadolibre_send_message`, `mercadolibre_list_questions`, `mercadolibre_answer_question`, `mercadolibre_get_seller_reputation`, `mercadolibre_listar_catalogos` |
| `mp_mercado_pago` | Real sin validar (requiere credenciales) | Rutas coinciden con la doc oficial (preferences, payments/search, refunds); falta access token de prueba. | `mercadopago_create_preference`, `mercadopago_get_preference`, `mercadopago_get_payment`, `mercadopago_list_payments`, `mercadopago_refund_payment`, `mercadopago_cancel_payment`, `mercadopago_validate_webhook_signature`, `mercadopago_listar_catalogos` |
| `mp_merida_municipal` | Entrega a humano (CAPTCHA o login) | Predial detrás de Radware Bot Manager con hCaptcha. | `merida_mun_consultar_predial` |
| `mp_monterrey_municipal` | Real, validado en vivo | Predial (ASP.NET, sin CAPTCHA) validado con expediente inexistente; tabla de adeudo sin ver con caso real. | `nl_consultar_predial`, `nl_listar_catalogos` |
| `mp_multas_mx` | Entrega a humano (CAPTCHA o login) | CDMX, EdoMex, Jalisco y San Pedro con CAPTCHA; NL solo refrendo. Con solver opt-in (2captcha): consulta real, sin validar en vivo (falta llave). | `multas_consultar`, `multas_estados_disponibles` |
| `mp_multas_vehiculares_mx` | Entrega a humano (CAPTCHA o login) | CDMX, EdoMex, Jalisco y San Pedro con CAPTCHA; NL consulta manual. Con solver opt-in (2captcha): consulta real, sin validar en vivo (falta llave). | `multas_consultar_por_placa`, `multas_calcular_total`, `multas_listar_sistemas` |
| `mp_no_antecedentes_penales_mx` | Entrega a humano (CAPTCHA o login) | Sin verificador público consultable (CDMX); EdoMex sin DNS. | `noantecedentes_verificar_constancia`, `noantecedentes_verificar_apto` |
| `mp_paypal_mx` | Real sin validar (requiere credenciales) | Cliente contra el OpenAPI oficial (transactions, balances); falta app REST con credenciales. | `paypal_mx_listar_transacciones`, `paypal_mx_consultar_transaccion`, `paypal_mx_balance` |
| `mp_portales_monitor` | Real, validado en vivo | Chequeo HTTP de 25 portales validado en vivo; los detrás de Akamai necesitan navegador con ventana. | `portales_listar`, `portales_check_http`, `portales_check_form_render`, `portales_health_dashboard`, `portales_configurar_alerta` |
| `mp_predial_mx` | Real, validado en vivo | Parcial: Toluca real; CDMX handoff (ALTCHA); resto del catálogo no revalidado en esta oleada. | `predial_consultar`, `predial_listar_municipios`, `predial_buscar_municipio`, `predial_estadisticas_catalogo` |
| `mp_puebla_municipal` | Entrega a humano (CAPTCHA o login) | Predial con CAPTCHA. Con solver opt-in (2captcha): consulta real, sin validar en vivo (falta llave). | `puebla_mun_consultar_predial` |
| `mp_queretaro_municipal` | Real, validado en vivo | Endpoints JSON del portal validados con clave ficticia, sin CAPTCHA. | `queretaro_mun_consultar_predial` |
| `mp_rappi_partners` | Real sin validar (requiere credenciales) | Cliente contra el dev-portal; credenciales solo para aliados aprobados. Ranking y comisiones: sin endpoint. | `rappi_listar_ordenes`, `rappi_consultar_orden`, `rappi_listar_productos_menu`, `rappi_actualizar_disponibilidad`, `rappi_consultar_ranking_zona`, `rappi_estimar_comisiones_mes` |
| `mp_repep_profeco` | Entrega a humano (CAPTCHA o login) | El portal tiene controles anti-automatización deliberados; no se emulan. | `repep_consultar`, `repep_filtrar_lote`, `repep_inscribir`, `repep_estadisticas` |
| `mp_repse_stps` | Real, validado en vivo | Búsqueda y padrón REPSE validados en vivo. | `repse_consultar_por_razon_social`, `repse_consultar_por_numero_registro`, `repse_verificar_proveedor` |
| `mp_repuve` | Entrega a humano (CAPTCHA o login) | reCAPTCHA v3 y body cifrado en el navegador; robo devuelve null (desconocido), nunca false. Con solver opt-in (2captcha): consulta real, sin validar en vivo (falta llave). | `repuve_consultar_niv`, `repuve_consultar_placa`, `repuve_verificar_robado` |
| `mp_resico_sat` | Cálculo normativo verificado | Cálculo local sobre tablas LISR; retención de plataformas por tipo de servicio verificada con LIF 2026 Art. 25 fr. VI. El criterio 'SCJN 2026' sigue sin verificar. | `resico_calcular_isr`, `resico_evaluar_estatus`, `resico_calendario`, `resico_retencion_plataforma`, `resico_solicitar_devolucion`, `resico_listar_tasas`, `resico_listar_plataformas` |
| `mp_retys_catalogo` | Real, validado en vivo | Validado solo con Chromium con ventana (Akamai bloquea headless y httpx). | `retys_listar_sectores`, `retys_buscar_tramite`, `retys_detalle_tramite`, `retys_exportar_dcat`, `retys_buscar_en_vivo` |
| `mp_sacpi_michoacan` | Bloqueado | Host sacpi.michoacan.gob.mx sin DNS (NXDOMAIN); selectores de 2026-06 sin revalidar. | `sacpi_consultar`, `sacpi_listar_municipios`, `sacpi_codigo_municipio` |
| `mp_sat_opinion_32d` | Real, validado en vivo | Consulta pública 32-D validada; descarga propia con e.firma sin validar. | `sat_opinion_32d_consultar`, `sat_opinion_32d_verificar_proveedor`, `sat_opinion_32d_descargar_propia` |
| `mp_sat_portal` | Real, validado en vivo | Parcial: listas 69 y 69-B validadas; login e.firma (CSF, padrón, vigencia) sin validar con e.firma real; buzón y acuses no implementados. | `sat_consultar_padron`, `sat_consultar_69b_efos`, `sat_consultar_69_incumplidos`, `sat_verificar_cfdi_uuid`, `sat_validar_uuid_estructura`, `sat_descargar_csf`, `sat_descargar_buzon_tributario`, `sat_descargar_cfdi_masivo`, `sat_agendar_cita`, `sat_verificar_efirma_vigente`, `sat_descargar_acuse`, `sat_actualizar_obligaciones`, `sat_listar_catalogos`, `sat_calendario_fiscal_por_regimen`, `sat_cfdi_prevalidar`, `sat_declaraciones_historico`, `sat_devolucion_estatus`, `sat_buzon_tributario_resumen` |
| `mp_sat_ws` | Real sin validar (requiere credenciales) | Firma y autenticación validadas con e.firma de prueba; solicitud/descarga con e.firma real sin validar. | `sat_ws_solicitar_descarga`, `sat_ws_verificar_solicitud`, `sat_ws_descargar_paquete` |
| `mp_sedatu_uso_suelo` | Entrega a humano (CAPTCHA o login) | Sin consulta pública nacional de uso de suelo; devuelve pasos con permitido: null. | `sedatu_buscar_tramite`, `sedatu_consultar_uso_suelo`, `sedatu_estimar_construccion`, `sedatu_listar_tramites` |
| `mp_sep_profesional` | Entrega a humano (CAPTCHA o login) | Cédula profesional exige token reCAPTCHA; resultado null (desconocido) con handoff. Con solver opt-in (2captcha): consulta real, sin validar en vivo (falta llave). | `sep_consultar_cedula`, `sep_consultar_por_datos`, `sep_validar_medico_para_consulta`, `sep_listar_profesiones_reguladas` |
| `mp_shopify_mx` | Real sin validar (requiere credenciales) | REST Admin API; versión por defecto subida a 2026-07 (2024-10 sin soporte). Falta tienda de desarrollo. | `shopify_list_products`, `shopify_get_product`, `shopify_get_inventory_level`, `shopify_update_inventory_level`, `shopify_list_orders`, `shopify_get_order`, `shopify_create_fulfillment`, `shopify_get_customer`, `shopify_list_webhooks`, `shopify_calculate_tax_mx`, `shopify_listar_catalogos` |
| `mp_simplifica_ciudadano` | Bloqueado | No hay fuente pública del avance por estado; fuera de mock devuelve ConfigError. | `simplifica_estado`, `simplifica_tracker_nacional`, `simplifica_comparar_estados` |
| `mp_softrestaurant` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `softrest_corte_z`, `softrest_ventas_periodo`, `softrest_inventario_actual`, `softrest_platillos_vendidos`, `softrest_meseros_ventas`, `softrest_mesas_estatus`, `softrest_parsear_export`, `softrest_listar_catalogos` |
| `mp_telmex_facturacion` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `telmex_descargar_factura`, `telmex_consumo_historico`, `telmex_listar_facturas` |
| `mp_tenencia_mx` | Cálculo normativo verificado | Cálculo local; montos 2026 de notas de prensa (confianza media o baja); se retiraron estados sin fuente. | `tenencia_calcular`, `tenencia_info_estado`, `tenencia_listar_estados`, `tenencia_comparar_estados` |
| `mp_tijuana_municipal` | Real, validado en vivo | Consulta de vivienda asegurada validada en vivo, sin CAPTCHA. | `tijuana_mun_consultar_predial`, `tijuana_mun_consultar_vivienda_asegurada` |
| `mp_trustly_mx` | Sin API pública | Trustly no opera en México; con credenciales devuelve ConfigError. | `trustly_create_payment`, `trustly_get_payment`, `trustly_list_payments`, `trustly_refund_payment`, `trustly_listar_catalogos` |
| `mp_uber_eats_partners` | Sin API pública | La doc de la Marketplace API no es pública; con credenciales devuelve ConfigError. | `uber_eats_listar_ordenes`, `uber_eats_consultar_orden`, `uber_eats_listar_productos_menu`, `uber_eats_actualizar_disponibilidad`, `uber_eats_consultar_ranking_zona`, `uber_eats_estimar_comisiones_mes` |
| `mp_verificacion_vehicular_mx` | Entrega a humano (CAPTCHA o login) | Estatus CDMX con CAPTCHA; calendario y costos 2026 de notas de prensa. Con solver opt-in (2captcha): consulta real, sin validar en vivo (falta llave). | `verificacion_consultar_estatus`, `verificacion_proximo_periodo`, `verificacion_listar_programas` |
| `mp_vivanuncios` | Sin verificar | El README no tiene sección 'Estado real' de la oleada 1. | `viv_buscar_anuncios`, `viv_obtener_detalle`, `viv_publicar_anuncio`, `viv_listar_catalogos` |
<!-- estado-mcps:fin -->

---

## Solver de CAPTCHA (opt-in)

`mcp-servers/shared/captcha_solver.py` resuelve el CAPTCHA del formulario con 2captcha; si falla un captcha de imagen y hay `ANTHROPIC_API_KEY`, usa visión como respaldo. **Está apagado por defecto**: sin la configuración, cada portal devuelve la entrega a humano.

```bash
export PLUGINS_MX_CAPTCHA_SOLVER=2captcha
export TWOCAPTCHA_API_KEY=...
```

| Tipo | Portales conectados |
|---|---|
| Imagen | SAF CDMX (tenencia, verificación, multas), predial Puebla |
| reCAPTCHA v2 / v3 / Enterprise | Cédula SEP, REPUVE, predial Guadalajara, adeudos Jalisco, multas San Pedro, CURP |
| Turnstile | Multas EdoMex |

- Nunca evade anti-bots de red: CURP (Akamai), INE (Cloudflare) y Mérida (Radware) bloquean antes del CAPTCHA; el tool detecta el bloqueo y entrega a humano sin gastar CAPTCHA.
- Excluidos por diseño: citas_monitor (apartar citas automáticamente le quita lugar a otras personas) y REPEP (anti-bot deliberado).
- Sin validar en vivo todavía: los portales con solver necesitan una llave para la primera prueba real.

---

## Productos destacados

### Cartera Predial Multi-municipio — https://skills-mexico.vercel.app/productos/predial
Estado (2026-10-14): parcial. Catálogo de 243 municipios (discovery de junio 2026). Revalidados: Toluca, Querétaro y Monterrey consultan predial en vivo (Tijuana, vivienda asegurada); CDMX, Guadalajara, Mérida y Puebla tienen CAPTCHA y entregan a humano (Guadalajara y Puebla, con solver opt-in). SACPI Michoacán está caído (sin DNS). Tools: `predial_consultar`, `predial_listar_municipios`, `predial_buscar_municipio`, `predial_estadisticas_catalogo`. El workflow `cartera-predial-multi-municipio` (inmobiliaria-mx) consolida la cartera en un CSV. Librería Python sin LLM: `clients/predial_mx_client`.

### Compliance REPSE (Art. 15 LFT) — https://skills-mexico.vercel.app/productos/repse
Estado (2026-10-14): real, validado en vivo contra repse.stps.gob.mx, sin CAPTCHA. Tools: `repse_consultar_por_razon_social`, `repse_consultar_por_numero_registro`, `repse_verificar_proveedor` (devuelve `puede_contratar_servicios_especializados: bool` y advertencias). Cache de 30 días. Sin REPSE vigente del proveedor, el contratante responde solidariamente por sus obligaciones laborales, fiscales y de seguridad social.

### ISN (32 estados, cálculo local) — https://skills-mexico.vercel.app/productos/isn
Estado (2026-10-14): cálculo normativo local; no consulta portales. Tasas 2026 de fuente secundaria (BHR 2026), confianza media: 2.5% (Aguascalientes) a 4.25% (Baja California); CDMX, Chihuahua y Quintana Roo 4%; Yucatán 3.75%; Zacatecas 3.5%; la mayoría 3%. Sinaloa (2.4%–3.0%) y Tabasco (3%–3.5%) no se calculan. `isn_generar_linea_captura` e `isn_descargar_declaracion` no están automatizadas: requieren la sesión del contribuyente.

```python
from mp_isn_mx.client import IsnMxClient

cliente = IsnMxClient()
for estado in ["CDMX", "JAL", "BC"]:
    r = cliente.calcular(500_000, estado)   # nómina gravable mensual
    print(r["estado"], r["tasa_pct"], r["isn_a_pagar"])
```

---

## Calidad y pruebas

```bash
cd mcp-servers && .venv/bin/pytest -q                       # unitarios, sin red
PLUGINS_MX_LIVE=1 .venv/bin/pytest -q -m live <ruta>       # contra el portal real
python3 scripts/eval-golden.py                              # cálculos fiscales deterministas
python3 scripts/generar-estado-mcps.py --check              # el sitio y el README están al día
```
En cada PR, el CI corre los tests de los MCPs, las evals golden, el lint de skills, la verificación de copias de `_shared`, SkillSpector, la validación de JSON y el escaneo de secretos.

---

## Seguridad y cumplimiento

- Validación experta antes de producción: las skills fiscales las debe revisar un contador; los contratos, un abogado; las plantillas de WhatsApp, Meta.
- Varias tasas estatales (ISN, ISH, tenencia) vienen de fuentes secundarias de 2026 y están marcadas con su nivel de confianza en cada README.
- Datos personales: la bitácora guarda solo hashes de RFC, CURP y correo. CURP e INE no cachean resultados e incluyen un aviso LFPDPPP.
- Buró de crédito: `mp_buro_credito_personal` exige el token de autorización del titular.
- Escrituras ante el SAT (actualizar obligaciones, citas): no se automatizan.
- Repo público: no se commitean credenciales ni capturas de navegador.

---

## Pendientes

| Tema | Qué falta |
|---|---|
| Login de usuario final | IMSS, INFONAVIT, bancos, Buró, CFE y Telmex necesitan credenciales de prueba y una captura (HAR) de cada flujo |
| Validación en vivo | Las APIs privadas y los portales con solver necesitan credenciales o llave para su primera prueba real |
| 11 MCPs sin "Estado real" | Los del grupo de login más aspel_contpaqi y softrestaurant (software local) |
| Verticales con lógica profunda | Varios verticales tienen skills de estructura sin cálculo propio |

---

## Datos públicos de este sitio (JSON estáticos; no hay API REST de consulta)

- `/data/mcp-estado.json` — estado, nota y tools de cada MCP
- `/mcp-manifest.json` — manifest MCP
- `/openapi.json` — describe los JSON estáticos de esta lista
- `/.well-known/ai-plugin.json` — manifest de plugin (solo datos estáticos)
- `/.well-known/security.txt` — política de divulgación responsable
- `/api/municipios.json` — catálogo de 243 municipios
- `/api/isn-tasas.json` — tasas ISN 2026 por estado, con fuente
- `/api/repse-stats.json` — base legal y verificación REPSE

---

## Contacto

- **Email:** elimoralsmendox@gmail.com
- **Demo de 20 minutos:** https://skills-mexico.vercel.app/#demo
- **GitHub:** https://github.com/elimorals/Skills_MX
- **Licencia:** Apache-2.0