Koskamo

Fiscal y nomina MX MCP

A remote MCP server providing deterministic SAT tax and payroll calculations for Mexico, including surcharges, ISR, CFDI validation, IMSS contributions, and severance settlements, verified against official legal sources to prevent AI hallucination.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Fiscal y nomina MX MCP logo, by MenteoramaCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-06Published by Menteorama
You need:50 calculations/month with a free key.Add the endpoint to Claude or your MCP client with your API key in the Authorization: Bearer header.
MCP endpoint (Streamable HTTP)
https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp
Vendor documentation

What its tools do

10 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

10 of 10 have a description · 10 of 10 declare behavior hints · 10 of 10 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Warning Advertises resources/templates/list but does not implement it
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Calculate late-payment surcharges and inflation updates
  • Validate CFDI 4.0 coherence before stamping
  • Estimate annual ISR by regime
  • Compute IMSS worker and employer contributions

Source and maintenance

Community listingRegistry 0.4.0

Protocol and capabilities

Server
menteorama-fiscal 0.4.0
MCP protocol negotiated in check
2025-11-25
Tools
10 advertised
Resources
1 advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {},
  "resources": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Capa fiscal MX. Calculos deterministas (mate, no LLM) sobre valores vigentes verificados contra fuente oficial (LIF / CFF / DOF). Cada resultado es INFORMATIVO, no asesoria fiscal: siempre verificar con un contador.

Tools

10 advertised

fiscal_recargos
Advertised by the server during the last successful anonymous check.
Advertised read-only

Calcula recargos por mora + actualizacion por pago tardio de una contribucion en Mexico (CFF Art. 17-A y 21). Determinista y auditable. Los meses se cuentan dia-a-dia desde el vencimiento (cada fraccion = mes completo). Si no se dan los INPC, el total NO incluye actualizacion y sera mayor. Informativo, no asesoria fiscal.

fiscal_recargos input schema
{
  "type": "object",
  "required": [
    "monto",
    "fecha_venc",
    "fecha_pago"
  ],
  "properties": {
    "monto": {
      "type": "number",
      "description": "Monto original del adeudo, en pesos.",
      "exclusiveMinimum": 0
    },
    "inpc_den": {
      "type": "number",
      "description": "Opcional. INPC del mes anterior al de vencimiento (denominador)."
    },
    "inpc_num": {
      "type": "number",
      "description": "Opcional. INPC del mes anterior al de pago (numerador, CFF 17-A)."
    },
    "fecha_pago": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Fecha en que se paga, YYYY-MM-DD."
    },
    "fecha_venc": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Fecha limite de pago, YYYY-MM-DD."
    }
  },
  "additionalProperties": false
}
fiscal_recargos annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_valores_vigentes
Advertised by the server during the last successful anonymous check.
Advertised read-only

Devuelve los valores fiscales vigentes verificados de Mexico para un anio (UMA, salario minimo, tasas de recargo y parcialidades), cada uno con su fuente oficial. Es el 'moat': datos mantenidos y verificados contra DOF/LIF/CFF. Informativo, no asesoria fiscal.

fiscal_valores_vigentes input schema
{
  "type": "object",
  "properties": {
    "anio": {
      "type": "integer",
      "minimum": 2024,
      "description": "Anio fiscal. Default: el mas reciente cargado."
    }
  },
  "additionalProperties": false
}
fiscal_valores_vigentes annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_calendario
Advertised by the server during the last successful anonymous check.
Advertised read-only

Obligaciones fiscales y fechas limite de un regimen fiscal mexicano. Con `mes` (1-12) calcula la fecha limite del pago mensual de ese periodo (dia 17 del mes siguiente, ajustado al siguiente dia habil por fin de semana). Con `rfc6` (6o digito del RFC) estima la extension del decreto de facilidades. Informativo, no asesoria fiscal.

fiscal_calendario input schema
{
  "type": "object",
  "required": [
    "regimen"
  ],
  "properties": {
    "mes": {
      "type": "integer",
      "maximum": 12,
      "minimum": 1,
      "description": "Opcional. Periodo mensual a declarar (1=enero)."
    },
    "rfc6": {
      "type": "integer",
      "maximum": 9,
      "minimum": 0,
      "description": "Opcional. 6o digito numerico del RFC, para la extension de dias."
    },
    "regimen": {
      "enum": [
        "resico_pf",
        "pf_actividad",
        "pf_arrendamiento",
        "pf_sueldos",
        "pm_general",
        "resico_pm"
      ],
      "type": "string",
      "description": "Regimen fiscal."
    }
  },
  "additionalProperties": false
}
fiscal_calendario annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_regimen_factores
Advertised by the server during the last successful anonymous check.
Advertised read-only

Devuelve los FACTORES para elegir regimen fiscal en Mexico (topes de ingreso, base gravable, tasas, exclusiones) segun tipo de persona, ingresos anuales y actividad. INFORMA, NO DECIDE: nunca recomienda un regimen; la eleccion es del contribuyente con su contador. Informativo, no asesoria fiscal.

fiscal_regimen_factores input schema
{
  "type": "object",
  "required": [
    "tipo_persona",
    "ingresos_anuales"
  ],
  "properties": {
    "actividad": {
      "enum": [
        "empresarial",
        "profesional",
        "arrendamiento",
        "sueldos"
      ],
      "type": "string",
      "description": "Opcional. Actividad principal (PF)."
    },
    "tipo_persona": {
      "enum": [
        "fisica",
        "moral"
      ],
      "type": "string",
      "description": "Tipo de contribuyente."
    },
    "ingresos_anuales": {
      "type": "number",
      "minimum": 0,
      "description": "Ingresos anuales estimados, en pesos."
    }
  },
  "additionalProperties": false
}
fiscal_regimen_factores annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_cfdi_validar
Advertised by the server during the last successful anonymous check.
Advertised read-only

Valida la coherencia de un CFDI 4.0 antes de emitirlo: relacion entre tipo de comprobante, uso, metodo/forma de pago y tipo de receptor, contra los catalogos del SAT. Determinista. NO timbra ni sustituye al PAC. Informativo, no asesoria fiscal.

fiscal_cfdi_validar input schema
{
  "type": "object",
  "required": [
    "tipo",
    "uso"
  ],
  "properties": {
    "uso": {
      "type": "string",
      "description": "Clave de Uso del CFDI (c_UsoCFDI), ej. G03, D01, CP01."
    },
    "tipo": {
      "enum": [
        "I",
        "E",
        "T",
        "N",
        "P"
      ],
      "type": "string",
      "description": "Tipo de comprobante (I,E,T,N,P)."
    },
    "metodo": {
      "enum": [
        "PUE",
        "PPD"
      ],
      "type": "string",
      "description": "Opcional. Metodo de pago (PUE/PPD)."
    },
    "receptor": {
      "enum": [
        "fisica",
        "moral"
      ],
      "type": "string",
      "description": "Opcional. Tipo de persona del receptor."
    },
    "forma_pago": {
      "type": "string",
      "description": "Opcional. Clave de forma de pago (ej. 03, 99)."
    }
  },
  "additionalProperties": false
}
fiscal_cfdi_validar annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_isr_estimado
Advertised by the server during the last successful anonymous check.
Advertised read-only

ESTIMA el ISR anual segun regimen, ingresos y deducciones, con la tarifa progresiva Art. 152 (Anexo 8 RMF 2026) o la tasa aplicable (RESICO/PM). Es una ESTIMACION: el ISR real depende de deducciones exactas, acreditamientos y pagos provisionales. Informativo, no asesoria fiscal.

fiscal_isr_estimado input schema
{
  "type": "object",
  "required": [
    "regimen",
    "ingresos"
  ],
  "properties": {
    "regimen": {
      "enum": [
        "resico_pf",
        "pf_actividad",
        "pf_arrendamiento",
        "pf_sueldos",
        "pm_general",
        "resico_pm"
      ],
      "type": "string",
      "description": "Regimen fiscal."
    },
    "ingresos": {
      "type": "number",
      "minimum": 0,
      "description": "Ingresos anuales, en pesos."
    },
    "deducciones": {
      "type": "number",
      "minimum": 0,
      "description": "Opcional. Deducciones anuales (no aplica a RESICO PF)."
    }
  },
  "additionalProperties": false
}
fiscal_isr_estimado annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_isr_retencion
Advertised by the server during the last successful anonymous check.
Advertised read-only

Calcula la retencion MENSUAL de ISR de salarios (Art. 96 LISR) menos el subsidio al empleo vigente (DOF 2025). Determinista. Devuelve ISR de tarifa, subsidio aplicado y retencion final. Informativo, no asesoria fiscal.

fiscal_isr_retencion input schema
{
  "type": "object",
  "required": [
    "ingreso_gravado"
  ],
  "properties": {
    "ingreso_gravado": {
      "type": "number",
      "minimum": 0,
      "description": "Ingreso gravado del mes (base de retencion), en pesos."
    }
  },
  "additionalProperties": false
}
fiscal_isr_retencion annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_imss
Advertised by the server during the last successful anonymous check.
Advertised read-only

Calcula las cuotas IMSS obrero-patronales del periodo sobre el SBC diario (topado a 25 UMA): Enfermedades y Maternidad, Invalidez y Vida, Retiro, Cesantia y Vejez (curva patronal 2026 por veces UMA), Guarderias, Riesgos de Trabajo e INFONAVIT. Determinista. Da sbc_diario o salario_diario. Estimacion (la prima RT es por empresa; los dias reales dependen del mes). Informativo, no asesoria.

fiscal_imss input schema
{
  "type": "object",
  "properties": {
    "dias": {
      "type": "number",
      "description": "Opcional. Dias del periodo (default 30.4).",
      "exclusiveMinimum": 0
    },
    "prima_rt": {
      "type": "number",
      "description": "Opcional. Prima de Riesgos de Trabajo (default Clase I minima)."
    },
    "sbc_diario": {
      "type": "number",
      "description": "SBC diario. Si se da, se usa directo.",
      "exclusiveMinimum": 0
    },
    "salario_diario": {
      "type": "number",
      "description": "Alterno a sbc_diario: salario diario que se integra con el factor.",
      "exclusiveMinimum": 0
    },
    "es_salario_minimo": {
      "type": "boolean",
      "description": "Opcional. Fuerza el piso de CyV (3.150%)."
    },
    "factor_integracion": {
      "type": "number",
      "description": "Opcional. Factor de integracion (default del anio)."
    }
  },
  "additionalProperties": false
}
fiscal_imss annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_aguinaldo
Advertised by the server during the last successful anonymous check.
Advertised read-only

Calcula el aguinaldo (LFT Art. 87): bruto (proporcional si aplica), parte exenta (30 UMA), parte gravada e ISR estimado. Determinista. Informativo, no asesoria fiscal.

fiscal_aguinaldo input schema
{
  "type": "object",
  "required": [
    "salario_diario"
  ],
  "properties": {
    "dias_aguinaldo": {
      "type": "number",
      "description": "Opcional. Dias de aguinaldo (default 15, minimo de ley).",
      "exclusiveMinimum": 0
    },
    "salario_diario": {
      "type": "number",
      "description": "Salario diario.",
      "exclusiveMinimum": 0
    },
    "dias_trabajados": {
      "type": "number",
      "minimum": 0,
      "description": "Opcional. Dias trabajados en el anio (default 365)."
    }
  },
  "additionalProperties": false
}
fiscal_aguinaldo annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
fiscal_finiquito
Advertised by the server during the last successful anonymous check.
Advertised read-only

Calcula finiquito (renuncia/termino) o liquidacion (despido injustificado), LFT: aguinaldo proporcional, vacaciones + prima, y para liquidacion 3 meses + 20 dias/anio + prima de antiguedad. Devuelve montos BRUTOS. La procedencia legal y el ISR se confirman con abogado/contador. No asesoria.

fiscal_finiquito input schema
{
  "type": "object",
  "required": [
    "salario_diario"
  ],
  "properties": {
    "tipo": {
      "enum": [
        "finiquito",
        "liquidacion"
      ],
      "type": "string",
      "description": "finiquito (renuncia) o liquidacion (despido injustificado)."
    },
    "dias_aguinaldo": {
      "type": "number",
      "description": "Opcional. Default 15.",
      "exclusiveMinimum": 0
    },
    "salario_diario": {
      "type": "number",
      "description": "Salario diario.",
      "exclusiveMinimum": 0
    },
    "antiguedad_anios": {
      "type": "number",
      "minimum": 0,
      "description": "Anios de antiguedad (para indemnizacion/prima)."
    },
    "salarios_pendientes": {
      "type": "number",
      "minimum": 0,
      "description": "Opcional. Salarios devengados no pagados (bruto)."
    },
    "dias_trabajados_anio": {
      "type": "number",
      "minimum": 0,
      "description": "Dias trabajados del anio en curso (aguinaldo proporcional)."
    },
    "prima_vacacional_pct": {
      "type": "number",
      "minimum": 0,
      "description": "Opcional. Default 0.25."
    },
    "dias_vacaciones_pendientes": {
      "type": "number",
      "minimum": 0,
      "description": "Dias de vacaciones no gozadas."
    }
  },
  "additionalProperties": false
}
fiscal_finiquito annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

1 advertised

Valores fiscales vigentes 2026 (Mexico)

Advertised by the server during the last successful anonymous check.

UMA, salario minimo, tasas de recargo y parcialidades 2026, con su fuente oficial.

Valores fiscales vigentes 2026 (Mexico) URI
fiscal://valores/2026

MIME type: application/json

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (2 of 2 answered).

  1. 2026-11-06: 1 of 1 checks answered
  2. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1003 ms
95th percentile latency
1003 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1003 ms · metadata changed · 10 tool(s), 1 resource(s); warnings: Advertises resources/templates/list but does not implement it

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http fiscal-y-nomina-mx-mcp https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add fiscal-y-nomina-mx-mcp --url https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable fiscal-y-nomina-mx-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "fiscal-y-nomina-mx-mcp": {
      "url": "https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "fiscal-y-nomina-mx-mcp": {
      "type": "streamableHttp",
      "url": "https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start fiscal-y-nomina-mx-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "fiscal-y-nomina-mx-mcp": {
      "type": "http",
      "url": "https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http fiscal-y-nomina-mx-mcp https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "fiscal-y-nomina-mx-mcp": {
      "serverUrl": "https://menteorama-fiscal-mcp.menteorama.workers.dev/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Fiscal y nomina MX MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.