Pandapé MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Pandapé MCP Revisa los candidatos de la vacante 4821 y dime cuáles cumplen 3 años de experiencia"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Pandapé MCP
Servidor MCP para gestión de reclutamiento sobre la API oficial de Pandapé v2 (ATS de Grupo Redarbor). Pensado para que Claude revise candidatos contra los criterios que tú le indiques.
Estado
Servidor MCP | ✅ funciona (handshake, 11 tools, errores limpios) |
Compilación y self-check | ✅ |
Descarga de CV por cookies | ✅ probada end-to-end (incluidos los modos de fallo) |
Llamadas reales a Pandapé | ⛔ bloqueado: faltan credenciales OAuth2 |
Todo está implementado y probado salvo lo único que no se resuelve desde el código:
client_id / client_secret. Se piden al Customer Success Specialist de tu cuenta.
Related MCP server: zoho-recruit
La API (verificado)
La API oficial existe y está documentada, aunque no se anuncie públicamente. Hay tres versiones:
Spec | Rutas | Nota |
| 60 | No permite listar candidatos de una vacante |
| 68 | La que usa este proyecto |
| 6 | Nicho (análisis de entrevistas, requisiciones) |
ATS web: https://ats.pandape.com (login en login.pandape.com) · Base de API: https://api.pandape.com.br · Auth: OAuth2 client_credentials (IdentityServer), scope PandapeApi.
LATAM:
https://login.pandape.com/connect/tokenBrasil:
https://login.pandape.com.br/connect/token
Ambos aceptan el grant (responden invalid_client con credenciales falsas, no unsupported_grant_type).
Descripciones del spec en portugués.
⚠️ Host de API y región. Solo resuelve
api.pandape.com.br;api.pandape.comno existe en DNS, aunque el token LATAM sí sale delogin.pandape.com. Confirma con tu CS qué host corresponde a tu cuenta de Perú y ajustaPANDAPE_API_URL.
Detalles que cuestan una tarde si no los sabes
PATCH /v2/matches/{idMatch}/update(mover de etapa) exigemultipart/form-data, no JSON — lleva un campoPhotobinario opcional. Con JSON falla.pandape_endpointsmuestra elcontentTypede cada endpoint con cuerpo; míralo antes de usarpandape_api.La API v2 no expone el CV en PDF. Expone algo mejor para evaluar: el CV como datos estructurados.
Revisar candidatos con tus criterios
pandape_revisar_candidatos trae el pool de una vacante con el CV ya estructurado:
resumen profesional, experiencias (puesto, empresa, fechas, actividades), estudios, habilidades,
idiomas, meses de experiencia, expectativa salarial, disponibilidad, y el Affinity que calcula Pandapé.
Flujo típico en Claude:
1. "Lístame las vacantes activas" → pandape_listar_vacantes (estado 2)
2. "¿Qué etapas tiene la vacante 4821?" → pandape_etapas_vacante
3. "Revisa los candidatos nuevos de la 4821 y
clasifícalos: necesito 3+ años en nómina,
Excel avanzado y que viva en Lima" → pandape_revisar_candidatos
4. "Dame el contacto de los tres mejores" → pandape_ver_candidato
5. "Mueve esos tres a Entrevista" → pandape_mover_candidato (requiere READONLY=0)Sesgo y minimización de datos
pandape_revisar_candidatos omite deliberadamente CPF, fecha de nacimiento, sexo, identidad de
género, orientación sexual, raza, discapacidad, estado civil, hijos, dirección y contacto. No aportan
al criterio profesional y su presencia sesgaría la evaluación. El contacto sale por
pandape_ver_candidato cuando ya decidiste avanzar con alguien concreto.
El self-check verifica esa exclusión (npm run check), así que no se rompe por accidente.
Uso rápido (sin credenciales de API): tu cookie del navegador
Funciona hoy con tu sesión del ATS, sin esperar credenciales:
npm ci && npm run build
# exporta la cookie del ATS con la extensión Cookie-Editor (Export → Netscape)
npm run set-cookie -- /ruta/cookies.txt # guarda en .auth/ (600) y VERIFICA la sesiónLuego, con el MCP registrado, el flujo es:
pandape_web_candidatos { idVacante }— candidatos de una vacante (idVacante = número de la URL del proceso).pandape_web_cv { idMatch }— CV completo en texto, listo para evaluar por criterios.pandape_web_descargar_cv { idMatch }— guarda el CV imprimible (HTML → PDF desde el navegador).
La cookie caduca con tu sesión; cuando pandape_diagnostico avise, re-exporta y vuelve a correr set-cookie.
Guía completa para operarlo (incluso para otro agente) en CLAUDE.md.
Descargar el PDF del CV
La API oficial no expone el documento del CV en ninguna de las tres versiones. Verificado:
CandidateResumeModel es solo datos, y los únicos campos de descarga que existen
(RequestDetailDocument.DownloadUrl, PreCollaboratorDocumentModel.Link) son de documentos de
requisiciones y de pre-colaboradores, no del pool de postulantes.
Así que el PDF va por cookies de tu sesión del ATS (pandape_descargar_cv). Configuración de una
sola vez:
1. La URL de descarga. En el ATS abre un candidato, clic derecho en el botón de descarga del CV →
Copiar dirección del enlace. Reemplaza el id por {idMatch} (o {idCandidate}):
PANDAPE_CV_URL="https://ats.pandape.com/Candidate/DownloadCv?idMatch={idMatch}"2. Las cookies. DevTools → Application → Cookies, o una extensión tipo Cookie-Editor. Dos formas:
PANDAPE_COOKIE="ASPNET_SessionId=…; .AspNetCore.Cookies=…" # cabecera cruda
PANDAPE_COOKIE_FILE="/ruta/cookies.json" # o un archivoEl archivo acepta cabecera cruda, JSON [{name,value}] de extensiones, o un storageState de
Playwright. Caducan con tu sesión: cuando expiren, el error te lo dice y las re-exportas.
Los documentos se guardan en PANDAPE_CV_DIR (por defecto ./cv). El nombre se sanea siempre, así
que la tool no puede escribir fuera de ese directorio. Se verifica la firma binaria: si el ATS
devuelve el HTML del login en vez del PDF, falla con un mensaje claro en vez de guardar basura
con extensión .pdf.
Para clasificar candidatos por criterios no necesitas el PDF:
pandape_revisar_candidatosya trae el CV como datos estructurados. Usa la descarga cuando quieras el documento original.
Puesta en marcha
npm install
npm run spec # descarga swagger.json (v2 por defecto)
npm run build
npm run check # self-check sin redConfiguración
Variable | Default | Descripción |
| — | Requerido. Lo entrega tu CS. |
| — | Requerido. |
|
| Host de la API |
|
| LATAM por defecto |
|
| |
|
|
|
|
| Ruta del spec |
| — | Plantilla de descarga del CV, con |
| — | Cookies de sesión del ATS (cabecera cruda) |
| — | …o archivo con las cookies |
|
| Dónde se guardan los PDFs |
| spec v2 | Solo para |
Registro en Claude Code / Desktop
{
"mcpServers": {
"pandape": {
"command": "node",
"args": ["/home/jairo/Documentos/pandape-mcp/dist/index.js"],
"env": {
"PANDAPE_CLIENT_ID": "…",
"PANDAPE_CLIENT_SECRET": "…",
"PANDAPE_TOKEN_URL": "https://login.pandape.com/connect/token",
"PANDAPE_API_URL": "https://api.pandape.com.br"
}
}
}
}Tools
Tool | Qué hace |
| Verifica credenciales, token y una llamada real. Empieza por aquí. |
| Vacantes con filtro de estado ( |
| Etapas del pipeline de una vacante |
| Pool de una vacante con el CV estructurado, listo para evaluar |
| Detalle completo con contacto, para un candidato concreto |
| Killer questions de la vacante |
| Mueve de etapa (escritura, multipart) |
| Descarga el PDF del CV vía cookies de sesión |
| Documentos de un pre-colaborador (el único caso con enlaces vía API) |
| Explora las 68 rutas del spec |
| Llama cualquier ruta, validada contra el spec |
Las dos últimas cubren lo que no tiene tool propia (requisiciones, finalistas y sus evaluaciones, clientes, sedes, usuarios, plantillas de vacante, diccionarios, campos personalizados) sin escribir 68 wrappers.
Seguridad y datos personales
Solo lectura por defecto. Las escrituras exigen
PANDAPE_READONLY=0explícito.El
client_secretva en la config del cliente MCP, nunca en el repo.Datos de candidatos = datos personales (Ley 29733 en Perú). La evaluación asistida por IA de personas conviene documentarla: criterios explícitos, evidencia citada y decisión humana al final.
legacy/
Scaffold anterior que hablaba con la SPA vía Playwright, archivado sin borrar (está en el primer commit de git). Se abandonó porque:
Asumía una SPA con API JSON en
/api/v1/*. Pandapé es ASP.NET Core MVC sobre IIS con Razor yjquery.unobtrusive-ajax: devuelve HTML, y/api/da 404.Sus escrituras no enviaban
__RequestVerificationToken, así que habrían fallado con antiforgery.Existiendo API oficial que cubre el caso de uso, el scraping añade riesgo legal y fragilidad sin aportar nada.
Ya no hace falta ni para el PDF: pandape_descargar_cv cubre ese caso con cookies y sin
dependencias de navegador. Rescátalo solo si las cookies resultan demasiado incómodas de renovar y
prefieres un login automatizado (requiere npm i playwright).
Available Tools
14 toolspandape_apiA
Llama cualquier endpoint de la API de Pandapé validando la ruta contra el spec OpenAPI. Úsalo para lo que no cubren las tools con nombre (requisiciones, finalistas, sedes, clientes, plantillas de vacante, diccionarios). Descubre rutas con pandape_endpoints. Ojo: los endpoints marcados multipart/form-data necesitan 'form', no 'body'.
Inputs: ruta (required), metodo (required), body, form, +1 more.
pandape_descargar_cvA
Descarga el documento del CV (PDF) de un candidato usando las cookies de tu sesión del ATS, y devuelve la ruta local para poder leerlo. La API oficial NO expone el CV como documento en ninguna versión, así que esto requiere PANDAPE_CV_URL + PANDAPE_COOKIE(_FILE). Para clasificar candidatos por criterios normalmente NO lo necesitas: pandape_revisar_candidatos ya trae el CV como datos estructurados. Usa esto cuando necesites el documento original.
Inputs: idMatch, idCandidato, nombreArchivo.
pandape_diagnosticoA
Verifica configuración y conectividad con la API de Pandapé: credenciales, token y una llamada real de prueba. Úsalo primero si algo falla.
Inputs: no named parameters.
pandape_documentos_precolaboradorA
Lista los documentos de un pre-colaborador (candidato ya en proceso de contratación) con sus enlaces de descarga. Este es el único caso donde la API oficial sí expone documentos.
Inputs: idPreColaborador (required).
pandape_endpointsA
Explora el catálogo de endpoints de la API de Pandapé (68 rutas: vacantes, candidatos, requisiciones, finalistas, clientes, sedes, usuarios, diccionarios, campos personalizados…). Devuelve método, ruta, parámetros y content-type. Usa el resultado con pandape_api.
Inputs: buscar.
pandape_etapas_vacanteA
Lista las etapas del pipeline (VacancyFolders) de una vacante: IdVacancyFolder, nombre y orden. Necesario para filtrar candidatos y para moverlos.
Inputs: idVacante (required).
pandape_listar_vacantesB
Lista las vacantes de la empresa: IdVacancy, cargo, ciudad, estado y fecha de publicación.
Inputs: estado, pagina, idVacante, porPagina.
pandape_mover_candidatoA
Mueve un candidato de una etapa del pipeline a otra. ESCRITURA: confirma con el usuario antes de ejecutar, y en lote confirma la lista completa. Requiere PANDAPE_READONLY=0.
Inputs: idMatch (required), idVacante (required), etapaOrigen (required), etapaDestino (required), +1 more.
pandape_preguntas_eliminatoriasA
Lista las preguntas eliminatorias (killer questions) configuradas en una vacante. Útil para saber qué se filtró antes de evaluar los CVs.
Inputs: idVacante (required).
pandape_revisar_candidatosA
Trae los candidatos (Matches) de una vacante con su CV en datos estructurados —resumen profesional, experiencias con actividades y empresas, estudios, habilidades, idiomas, meses de experiencia y expectativa salarial— listos para evaluarlos contra los criterios que indique el usuario. Omite a propósito datos sensibles (CPF, edad, sexo, raza, orientación, estado civil, dirección, contacto) porque no aportan al criterio profesional y sesgarían la evaluación; el contacto está en pandape_ver_candidato. Al evaluar: cíñete a los criterios dados, cita evidencia del CV para cada juicio y di explícitamente cuándo el CV no alcanza para decidir.
Inputs: idVacante (required), pagina, idEtapa, porPagina.
pandape_ver_candidatoA
Detalle COMPLETO y sin filtrar de una candidatura, incluido el contacto (email y teléfonos). Úsalo cuando ya decidiste avanzar con alguien concreto, no para revisar en lote.
Inputs: idMatch (required), incluirCuestionarios.
pandape_web_candidatosA
Lista los candidatos de una vacante usando tu SESIÓN WEB del ATS (cookies), sin necesidad de credenciales de API. Devuelve los idMatch para luego leer cada CV con pandape_web_cv. El idVacante es el número que aparece en la URL del proceso en el ATS (/Company/Match/Matches/).
Inputs: idVacante (required).
pandape_web_cvA
Lee el CV COMPLETO de un candidato como texto, usando tu sesión web (cookies). Es la vía para revisar candidatos por criterios cuando aún no tienes credenciales de API. Al evaluar: cíñete a los criterios que indique el usuario, cita evidencia del CV y di cuándo el CV no alcanza para decidir. Recuerda que incluye datos personales; trátalos como sensibles.
Inputs: idMatch (required).
pandape_web_descargar_cvA
Guarda la vista imprimible del CV de un candidato (HTML) vía tu sesión web, y devuelve la ruta local. El ATS no ofrece el CV como PDF binario descargable: genera una página imprimible que el navegador convierte a PDF. Este HTML conserva todo el contenido del CV.
Inputs: idMatch (required), nombreArchivo.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Several tools overlap in purpose, especially around CV retrieval and candidate listing. For example, pandape_descargar_cv and pandape_web_descargar_cv both fetch CV files via web sessions, and pandape_revisar_candidatos overlaps with pandape_web_cv for reviewing candidate CVs. The detailed descriptions help clarify when to use each, but the boundaries are not instantly obvious.
All tools share the 'pandape_' prefix, which provides a clear brand, but the remainder mixes styles: some are verb_noun (listar_vacantes, mover_candidato), others are noun-based (diagnostico, endpoints, api), and some have awkward constructions like web_descargar_cv. This inconsistency makes it harder to predict tool names.
14 tools is within the expected 3-15 range and the server appears to cover a broad ATS domain. However, the presence of multiple nearly redundant CV-related tools (descargar_cv vs web_descargar_cv) and the generic API fallback makes the set feel slightly less focused than it could be.
The set covers core read operations (list vacancies, stages, candidates, CV retrieval) and one write operation (move candidate). Missing are obvious lifecycle operations like create/update/delete vacancies, add candidates to vacancies, or update candidate info. The generic pandape_api endpoint helps fill these gaps but does not make the tool surface complete on its own.
Maintenance
Related MCP Connectors
AI resume triage for recruiters. Query your candidate pool from Claude or ChatGPT.
Review candidates and run hiring actions in InterviewFlowAI from Claude, ChatGPT, Codex and more.
Create contacts, move deals, send proposals and invoices, read your inbox, from Claude or ChatGPT.
Connect Claude, Cursor, Codex, and other MCP clients to manage your Cavuno job board.
Related MCP Servers
- AlicenseAqualityDmaintenanceConnects Claude to the Ashby ATS to manage the hiring pipeline through natural conversation. It enables users to browse jobs, manage candidate profiles, track applications, and coordinate interview stages.245MIT
- FlicenseBqualityDmaintenanceEnables Claude to manage Zoho Recruit ATS operations including candidates, jobs, interviews, analytics, email, and AI-assist through natural language.20-
- AlicenseAqualityDmaintenanceEnables managing Recruitee/Tellent recruiting pipelines from Claude, including reading roles and candidates, creating candidates, and writing evaluations and notes with previews and safe write operations.14MIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude to securely search, read, and update your ATS data — candidates, mandates, pipelines, tasks, and interviews — through natural language, with configurable write permissions and confirmation for actions like scheduling and emailing.-