elimorals / Skills_MX

# Skills 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 |
---
## Contenido
1. Estado de los MCPs
2. Inicio rápido
3. Cómo está organizado
4. Plugins verticales
5. MCP servers
6. Configuración y credenciales
7. Solver de CAPTCHA (opt-in)
8. Calidad y pruebas
9. Seguridad y cumplimiento
10. Pendientes
11. Documentación
12. Licencia
---
## Estado de los MCPs
Cada MCP declara en su README una sección **"Estado real"** con lo que se validó en vivo, cuándo y contra qué URL. La tabla de abajo se genera de esas secciones; no se edita a mano.
### 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 |
**Qué significa cada categoría:**
| Categoría | Significado |
|---|---|
| Real, validado en vivo | Consulta el portal o API oficial y se probó en vivo; la evidencia está en su README |
| Real sin validar | Cliente escrito contra la documentación oficial; falta una credencial para probarlo |
| Entrega a humano | El portal exige CAPTCHA o login: el tool devuelve URL, pasos y campos prellenados |
| Sin API pública | El proveedor no ofrece API; el tool responde un error explícito con la alternativa |
| Cálculo normativo | Cálculo local con tasas y reglas citadas a su fuente (LFT, LISR, LFD, leyes estatales) |
| Bloqueado / sin verificar | Portal caído o sin fuente pública / aún sin la revisión de la oleada 1 |
El detalle por MCP (estado, nota y tools) está en `mcp-servers/CATALOGO.md`.
**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.
---
## Inicio rápido
### Instalar plugins en Claude Code
 [code] 
`core-mexico` (CFDI, IVA y retenciones, RFC, MXN, LFPDPPP, WhatsApp) es la de