Reclee

API y MCP de Reclee

Integra Reclee desde tu código con la API REST o conecta un asistente de IA con el servidor MCP.

Reclee es un ATS y CRM con sourcing para agencias de reclutamiento. Todo lo que tu equipo hace en la app —publicar vacantes, mover candidatos por el pipeline, buscar talento, revelar contactos, llevar el CRM de clientes— también se puede hacer desde afuera, con dos puertas que comparten las mismas reglas:

  • La API REST (https://app.reclee.com/api/v1): HTTP y JSON, para scripts, integraciones y backends propios.
  • El servidor MCP (https://app.reclee.com/api/mcp): las mismas operaciones como tools para un cliente MCP (Claude, Claude Code, ChatGPT u otro agente).

Las dos usan la misma credencial (una API key del workspace), el mismo límite de pedidos y el mismo ejecutor: una acción hecha por REST y la misma hecha por MCP producen exactamente el mismo resultado.

Qué puedes hacer

ÁreaEjemplos
VacantesCrear borradores, editarlas, publicarlas, cerrarlas y reabrirlas; equipo, suscriptores, notas y links de shortlist para el cliente.
Pipeline (ATS)Sumar candidatos, moverlos de etapa, descalificar o restaurar, etiquetas, comentarios, preguntas de screening, contratar.
Entrevistas e informesAgendar entrevistas, generar preguntas, cargar transcripciones, proponer la scorecard y armar el informe para el cliente.
Talent poolPerfiles, tags, notas, contactos, listas (bookmarks), carga de CVs y planillas, fusión de duplicados.
Búsqueda y sourcingBuscar personas fuera del workspace, enriquecer perfiles, definir el perfil ideal (ICP) y correr el sourcing que arma la longlist.
Match scoreCalcular cuánto encaja cada candidato con los criterios de la vacante.
ContactosRevelar el email laboral, el personal o el teléfono de una persona (consume créditos).
CRMEmpresas (leads), contactos del lado del cliente, actividad, requests (las búsquedas que pide un cliente) y contrataciones.

Cómo está organizada la API

La API separa leer de escribir:

  • Las lecturas son GET sobre recursos: GET /job-posts, GET /job-posts/{jobPostId}, GET /crm/leads… Las listas se paginan siempre igual.
  • Las escrituras de negocio son acciones con nombre: POST /actions/<tool>, por ejemplo POST /actions/close_job_post o POST /actions/move_application_stage. Cada acción valida su cuerpo con su propio JSON Schema y es la misma operación que la tool homónima del MCP.

Algunos recursos también aceptan POST, PATCH o PUT directo (por ejemplo, editar tu perfil con PATCH /account/me); la referencia REST dice qué métodos acepta cada ruta. Muchas acciones devuelven, además del dato, next: qué le falta todavía al objeto y qué acciones siguen.

# Leer
curl https://app.reclee.com/api/v1/job-posts?status=ACTIVE \
  -H "Authorization: Bearer $RECLEE_API_KEY"

# Escribir
curl -X POST https://app.reclee.com/api/v1/actions/create_note \
  -H "Authorization: Bearer $RECLEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "jobPostId": "3f8a2b6c-1d4e-4a7b-9c2d-8e5f6a7b8c9d", "body": "El cliente pidió priorizar inglés avanzado." }'

Direcciones base

QuéURL
API RESThttps://app.reclee.com/api/v1
Servidor MCPhttps://app.reclee.com/api/mcp
Especificación OpenAPI 3.1 (pública, sin key)https://app.reclee.com/api/v1/openapi.json

Por dónde seguir

En esta página