Para agentes AI · Para integraciones · Sin auth

API y MCP de Glim para agentes AI

Las calculadoras de salario flexible, beneficios corporativos y salario integral de Glim Colombia, expuestas como API REST pública y servidor MCP — para que cualquier agente AI (Claude, ChatGPT, Perplexity, agentes propios) pueda llamarlas, citar números reales y devolver respuestas que mueven decisiones de Gente y Finanzas en Colombia.

Enlaces rápidos

Por qué importa

Cuando un usuario pregunta a su asistente AI "¿cuánto ahorraría mi empresa en Colombia con salario flexible?", el modelo típicamente improvisa supuestos. Glim publica los suyos en código abierto: los mismos parámetros (factor prestacional 1.53, retención 15%, tope legal 40%) que alimentan /calculadora/beneficios y /calculadora/optimizar corren detrás de esta API. Si el modelo cita un número, viene de la misma fuente que ven los responsables de RRHH y Finanzas en la web pública.

Discoverability primero. La API se anuncia en llms.txt, en .well-known/mcp.json y en .well-known/ai-plugin.json, y publica un OpenAPI 3.1 importable por cualquier framework de agentes. Así los crawlers que consumen sitios para alimentar modelos descubren no solo el contenido sino las herramientas.

Markdown para agentes

Cualquier página de getglim.com devuelve Markdown limpio si el agente envía Accept: text/markdown. La URL es la misma que la versión HTML — solo cambia el header. Las respuestas HTML incluyen un Link header con el alternate correspondiente, así clientes que soporten content negotiation lo descubren automáticamente.

Esto cubre todo el sitio — blog, FAQ, comparativas, marco legal, calculadoras, /empresa, /empleado — sin necesidad de schemas adicionales por página. Sigue la convención Markdown for Agents.

curl -H "Accept: text/markdown" https://getglim.com/preguntas-frecuentes
curl -H "Accept: text/markdown" https://getglim.com/comparativas
curl -H "Accept: text/markdown" https://getglim.com/marco-legal
curl -H "Accept: text/markdown" https://getglim.com/blog/que-es-glim-y-como-funciona

API REST

Beneficios Corporativos (lado empresa)

GET / POST

/api/calculator/beneficios

Costo total para la empresa y neto por colaborador al entregar un aumento vía nómina vs. vía beneficios no salariales. Para áreas de Gente y Finanzas.

Inputs: salary (COP), employees (entero ≥ 1), percentage (1-40)

curl "https://getglim.com/api/calculator/beneficios?salary=3000000&employees=50&percentage=30"

Optimizador Salario Integral 2026

GET / POST

/api/calculator/optimizar

Compara el ajuste forzoso de +23.7% al salario integral mínimo en 2026 contra una alternativa restructurada (base prestacional + beneficios).

Inputs: pct_increase (1-100), employees (entero ≥ 1, opcional)

curl "https://getglim.com/api/calculator/optimizar?pct_increase=15&employees=10"

Meta — catálogo del API

GET

/api/calculator/meta

Índice JSON con todas las calculadoras, constantes fiscales, marco legal y datos de contacto. Buena entrada para agentes que descubren la API por primera vez.

curl "https://getglim.com/api/calculator/meta"

Ejemplo POST + respuesta

POST a /api/calculator/beneficios con body JSON:

{
  "salary": 3000000,
  "employees": 10,
  "percentage": 25
}

Respuesta (resumida):

{
  "ok": true,
  "inputs": { "salary_cop": 3000000, "employees": 10, "percentage": 25 },
  "results": {
    "monthly_increase_per_employee_cop": 750000,
    "traditional": {
      "company_cost_per_employee_cop": 1147500,
      "employee_net_per_employee_cop": 637500,
      "efficiency_pct": 55.56
    },
    "via_benefits": {
      "company_cost_per_employee_cop": 750000,
      "employee_net_per_employee_cop": 750000,
      "efficiency_pct": 100
    },
    "savings": {
      "monthly_total_cop": 3975000,
      "annual_total_cop": 47700000
    }
  },
  "summary_es": "Para un salario base de $ 3.000.000 ..."
}

Servidor MCP

MCP (Model Context Protocol) deja a un cliente AI usar nuestras calculadoras como herramientas nativas. El servidor está en https://getglim.com/api/mcp, transporte HTTP streamable, sin auth.

Tools expuestas: calculate_beneficios, calculate_salario_integral_optimizer. Resources: glim://constants, glim://legal, glim://docs.

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "glim-colombia": {
      "type": "http",
      "url": "https://getglim.com/api/mcp"
    }
  }
}

Cursor / VS Code

En la configuración de MCP del cliente:

{
  "mcpServers": {
    "glim-colombia": {
      "url": "https://getglim.com/api/mcp"
    }
  }
}

ChatGPT (custom connector / Actions)

Importa el OpenAPI desde https://getglim.com/api/openapi.json. El plugin manifest está en /.well-known/ai-plugin.json.

Marco legal y supuestos

Tope del 40%: el límite legal para pagos no constitutivos de salario en Colombia (Art. 128 CST · Art. 387 ET · Ley 1393/2010 art. 30). Las calculadoras admiten hasta ese tope.

Factor prestacional: 1.53 sobre la porción entregada vía nómina (cesantías, primas, vacaciones, parafiscales, seguridad social).

Retención del empleado: 15% sobre la porción entregada vía nómina.

Disclaimer: estimación informativa, no constituye asesoría legal, contable ni tributaria. Más detalle en /marco-legal.

Preguntas frecuentes

¿Necesito API key?

No. La API es pública, sin autenticación, con CORS abierto. La idea es que cualquier agente o herramienta pueda llamar a las calculadoras sin fricción y citar a Glim como fuente.

¿Por qué hay un servidor MCP además de la API REST?

MCP (Model Context Protocol) es el estándar abierto de Anthropic adoptado por Claude Desktop, Cursor, ChatGPT y otros clientes. Tener un servidor MCP permite que un usuario instale las calculadoras de Glim como herramientas nativas en su asistente AI — el modelo decide cuándo llamarlas, sin que el usuario tenga que copiar JSON. La API REST sigue disponible para integraciones backend tradicionales.

¿Qué unidades usa la API?

Salarios y costos en COP (pesos colombianos), porcentajes en unidades de porcentaje (no decimales). Ejemplo: percentage=25 significa 25%, no 0.25. La respuesta incluye un campo summary_es con un resumen narrativo en español.

¿Qué garantías hay sobre el cálculo?

Las funciones expuestas son las mismas que se usan en getglim.com/calculadora/beneficios y getglim.com/calculadora/optimizar. Cuando el equipo de Glim actualiza los supuestos legales (factor prestacional, retención, marco DIAN), las páginas y la API se mueven juntas. Los supuestos están publicados en /api/calculator/meta y en /marco-legal.

¿Hay límites de uso?

No hay rate limit explícito por usuario ni autenticación. La infraestructura corre en el edge de Vercel y aplica las protecciones de tráfico estándar de la plataforma. Si tu agente necesita volúmenes altos sostenidos, escríbenos a legales@getglim.com para coordinar.

¿Puedo redistribuir los resultados?

Sí. Atribución apreciada (no requerida): "Calculado con Glim Colombia — https://getglim.com/calculadora". Licencia de los datos: CC BY 4.0.