Rippling MCP Server

Servidor MCP de Rippling

Un servidor de Model Context Protocol (MCP) de código abierto para la plataforma de RR. HH./TI/Finanzas de Rippling. Conecta cualquier agente de IA o LLM a tu espacio de trabajo de Rippling: consulta empleados, gestiona solicitudes de ausencia, visualiza la estructura de la empresa y mucho más.

Características

• 18 herramientas en 6 dominios: Empresa, Empleados, Organización, Ausencias, Grupos, Actividad
• Autenticación mediante token Bearer — configuración sencilla con token de API, sin necesidad de OAuth
• Consciente de límites de tasa — respeta los encabezados de límite de tasa de Rippling
• Errores aptos para IA — mensajes de error estructurados con sugerencias de solución accionables
• TypeScript — seguridad total de tipos, construido con @modelcontextprotocol/sdk

Inicio rápido

1. Obtén un token de API de Rippling

Ve a Rippling > Configuración > Tokens de API > Crear token de API. Copia el token.

2. Configura en Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "rippling": {
      "command": "npx",
      "args": ["-y", "rippling-mcp-server"],
      "env": {
        "RIPPLING_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

3. Úsalo

Pregúntale a Claude cosas como:

• "Enumera todos los empleados de Ingeniería"
• "¿Quién tiene solicitudes de ausencia pendientes?"
• "Muéstrame la estructura organizativa de la empresa"
• "¿Cuál es el saldo de PTO de Alice?"

Referencia de herramientas

Empresa

Herramienta	Descripción
get_company	Obtén detalles de la empresa (nombre, dirección, ubicaciones)
list_departments	Enumera todos los departamentos con jerarquía
list_work_locations	Enumera ubicaciones de trabajo y direcciones

Empleados

Herramienta	Descripción
list_employees	Enumera empleados activos (paginado)
get_employee	Obtén un empleado específico por ID
list_all_employees	Enumera todos los empleados, incluidos los desvinculados
search_employees	Busca por nombre, correo electrónico, cargo o departamento

Organización

Herramienta	Descripción
list_teams	Enumera equipos y relaciones de subequipos
list_levels	Enumera niveles de puesto (IC, Gerente, Ejecutivo)
list_custom_fields	Enumera definiciones de campos personalizados

Gestión de ausencias

Herramienta	Descripción
get_leave_balances	Obtén saldos de PTO/ausencia por enfermedad de un empleado
list_leave_requests	Enumera solicitudes de ausencia (filtra por estado, fecha, solicitante)
process_leave_request	Aprueba o rechaza una solicitud de ausencia pendiente
list_leave_types	Enumera todos los tipos de ausencia configurados para la empresa

Grupos

Herramienta	Descripción
list_groups	Enumera todos los grupos
create_group	Crea un nuevo grupo con miembros
update_group	Actualiza el nombre del grupo o sus miembros
delete_group	Elimina un grupo

Actividad

Herramienta	Descripción
get_company_activity	Obtén eventos de actividad (contrataciones, cambios, desvinculaciones)

Configuración

Variable	Obligatoria	Predeterminado	Descripción
RIPPLING_API_TOKEN	Sí	—	Tu token de API de Rippling
RIPPLING_BASE_URL	No	https://api.rippling.com/platform/api	URL base de la API

Para pruebas en sandbox, establece RIPPLING_BASE_URL en https://sandbox.rippling.com/api/platform/api.

Desarrollo

# Install dependencies
npm install

# Run in development mode
RIPPLING_API_TOKEN=your_token npm run dev

# Run tests
npm test

# Build for production
npm run build

# Type check
npm run lint

Cómo funciona

Este servidor envuelve la API de la plataforma Rippling (V1) y la expone a través del Model Context Protocol. Cuando un agente de IA llama a una herramienta, el servidor:

1. Valida la entrada mediante esquemas de Zod
2. Realiza solicitudes autenticadas a la API de Rippling
3. Gestiona los límites de tasa automáticamente
4. Devuelve respuestas JSON estructuradas (o mensajes de error accionables)

Limitaciones

• Los endpoints de empleados son de solo lectura (restricción de la API V1 de Rippling)
• Los permisos del token de API determinan qué campos se devuelven por empleado
• Los límites de tasa los aplica Rippling (supervisa mediante los encabezados de respuesta)
• El procesamiento de solicitudes de ausencia requiere permisos de administrador adecuados

Licencia

MIT

Contribuciones

Se aceptan problemas y solicitudes de extracción (PR).