mcp-elempleo
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., "@mcp-elempleo busca ofertas de desarrollador backend remoto en elempleo"
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.
mcp-elempleo
Servidor MCP para elempleo.com (Colombia). Con él puedes:
Buscar ofertas, ver su detalle y evaluar si encajan con tu perfil.
Postular, una oferta a la vez y con tu confirmación explícita.
Mantener tu hoja de vida al día a partir de un archivo único con tus datos: el perfil maestro.
Funciona con cualquier cuenta de elempleo. Ningún dato personal está escrito en el código: todo sale del perfil maestro o de la hoja de vida que ya tengas en elempleo.
Instalación
Requisitos: Node.js 20 o superior y un navegador basado en Chromium (Chrome, Edge, Brave o Chromium), que solo se usa para iniciar sesión.
Regístralo en tu cliente MCP (por ejemplo ~/.cursor/mcp.json o la configuración de Claude Desktop). npx lo descarga de npm y lo mantiene actualizado:
{
"mcpServers": {
"elempleo": {
"command": "npx",
"args": ["-y", "mcp-elempleo"],
"env": { "PERFIL_MAESTRO": "/ruta/a/mi/perfil-maestro.json" }
}
}
}Es autónomo: incluye el estándar del perfil maestro (src/perfil-maestro.js, perfil-maestro.schema.json y PERFIL-MAESTRO.md). Los demás MCP de empleo traen la misma copia, así que todos comparten el mismo perfil.
También puedes instalarlo desde el código fuente:
git clone https://github.com/Jucamhc/mcp-elempleo.git
cd mcp-elempleo
npm instally usar "command": "node" con "args": ["/ruta/a/mcp-elempleo/src/index.js"].
Variables de entorno (todas opcionales)
Variable | Por defecto | Para qué |
|
| Ruta de tu perfil maestro (la misma para todos los MCP) |
| carpeta del perfil maestro | Base para las rutas relativas de |
|
| Sesión (cookies), caché de catálogos, perfil del navegador y respaldos |
| se detecta | Ruta del ejecutable del navegador si no está en la ubicación habitual |
La sesión y los respaldos quedan en ~/.elempleo/, fuera de carpetas sincronizadas. El MCP nunca muestra cookies ni credenciales.
Related MCP server: Computrabajo Open MCP
Primeros pasos
iniciar-sesion: abre el navegador en el login de elempleo. Entras a mano (hay reCAPTCHA y verificación en dos pasos) y el MCP guarda la sesión.Si aún no tienes perfil maestro,
construir-perfil-maestrote pide una fuente:La URL de tu LinkedIn. LinkedIn no deja leer perfiles automáticamente, así que el MCP te indica cómo exportarlo con "Más → Guardar en PDF".
Tu CV en PDF y tu foto. El MCP extrae el texto y el asistente arma el perfil según el estándar para que lo revises.
Lo que ya tienes en elempleo (
desde_portal: true).
Cuando lo apruebes,
guardar-perfil-maestrolo valida y lo guarda con la foto y el CV.comparar-perfil: muestra qué falta, qué está desactualizado y qué sobra en elempleo frente al perfil maestro.actualizar-perfilpor sección: primero sinaplicar, para ver el plan antes → después; luego conaplicar: true.
Perfil maestro
Es un JSON que sirve como única fuente de verdad y sigue el estándar compartido. El MCP lo lee y nunca inventa datos. Campos que usa elempleo (ver perfil-maestro.ejemplo.json):
Campo | Uso |
|
|
| Perfil profesional y primera línea de la nota al empleador |
| Opcional: nombre exacto en el catálogo de elempleo. Si falta, se usa tu título más alto |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| Ruta del PDF, o un objeto |
| Respuestas reutilizables (p. ej. |
Cómo se eligen las opciones de los catálogos de elempleo
elempleo pide elegir cargo equivalente, sector, ciudad, nivel educativo, área de cursos y profesión de sus propias listas. El MCP elige la opción que más palabras comparte con tu dato y la muestra en el plan para que la revises. Si quieres fijarla, agrega el nombre exacto del catálogo en portales.elempleo (los demás MCP ignoran esa clave):
En
experiencia[].portales.elempleo:cargo_equivalente,sectoryciudad.En
formacion[].portales.elempleo:nucleo_conocimiento. El nivel y la ciudad usan los campos estándarnivelyciudad.En
certificaciones[].portales.elempleo:area; o unarea_cursosgeneral enportales.elempleode la raíz.
Herramientas
Herramienta | Qué hace |
| Sesión |
| Búsqueda (sin sesión) |
| Compara la oferta con tus preferencias (modalidad, salario según contrato, tecnologías declaradas e inglés) |
| Lee el formulario de postulación y redacta la nota con datos del perfil maestro |
| Exige |
| Envía el cuestionario de filtro posterior a la postulación. Exige |
| Estado de tus postulaciones |
| Herramientas estándar del perfil maestro: crearlo desde LinkedIn, un CV en PDF con foto o elempleo; validarlo y guardarlo; revisarlo |
| Hoja de vida. Secciones: |
| Foto y archivos |
Toda escritura respalda antes lo que había (en ~/.elempleo/respaldos/) y solo borra los ids que pases en eliminar_ids.
Referencia técnica
elempleo no tiene API pública; la web usa una API interna (ASP.NET MVC con tokens anti-falsificación).
Búsqueda (sin sesión)
GET /co/ofertas-empleo/?Trabajo=<palabra>da las cookies y el token de<span class="js-search-api-token">.POST /co/api/joboffers/findbyfiltercon la cabecera__RequestVerificationTokeny el cuerpo:{"query":"desarrollador","salaryInfo":[],"contractType":0,"workModality":101, "cities":[],"publishDate":0,"pageIndex":1,"pageSize":20,"sortExpression":"PublishDate_Desc"}
Filtro | Valores |
| 0 todos, 100 presencial, 102 híbrido, 101 remoto |
| 0 todos, 1 indefinido, 2 definido, 3 prestación de servicios, 4 aprendizaje, 5 obra o labor, 6 otro |
| 2 menos de 1 · 3 1–1,5 · … · 10 4,5–5,5 · 23 5,5–6 · 27 6–8 · 28 8–10 · 29 10–12,5 · 30 12,5–15 · 31 15–18 · 32 18–21 · 33 más de 21 |
| 1 hoy y ayer, 2 una semana, 3 dos semanas, 4 un mes, 6 más de un mes |
Detalle: GET /co/api/joboffers/getjoboffer?jobOfferId=<id>.
Postulación (con sesión)
Postulación rápida:
POST /co/JobOffers/JobOfferDetail/SaveQuickApplication?JobOfferId=&CurrentAttachmentCVId=conAttachments.SelectedIds.Normal:
POST /co/JobOffers/JobOfferDetail/Save?jobOfferId=conApplicationNote(opcional, máx. 2.000 caracteres).Response: 1 enviada, 2 se postula en la web de la empresa, 3 hoja de vida incompleta, 4 ya postulado, 5 redirige a un paso adicional (por verificar).Mis postulaciones:
POST /co/api/jobOffersAplication/filterscon el token de.js-application-api-token.
Hoja de vida
Página /co/hoja-de-vida. Los catálogos vienen en atributos data-* de .js-conf (ciudades, cargos, sectores, instituciones, profesiones, áreas de cursos, habilidades, países).
Sección | Endpoint |
Foto |
|
Perfil profesional |
|
Experiencia laboral |
|
Educación formal |
|
Cursos y diplomados |
|
Idiomas |
|
Redes sociales |
|
Habilidades |
|
Seguridad social |
|
Archivos (CV) |
|
Fechas en dd/mm/aaaa; formularios en x-www-form-urlencoded al estilo jQuery.param.
Pendiente de verificar
Qué trae el código de respuesta
5al postular (posibles preguntas de filtro o pruebas).
Available Tools
19 toolsactualizar-perfilA
Actualiza una sección de la hoja de vida desde el perfil maestro. Sin aplicar devuelve el plan exacto (antes → después) para mostrarlo al usuario; con aplicar=true respalda en ~/.elempleo/respaldos/ y guarda. Solo borra los ids indicados en eliminar_ids. seguridad_social usa los datos que el usuario dé; nunca los supongas.
Inputs: seccion (required), aplicar, eliminar_ids.
buscar-ofertasB
Busca ofertas en elempleo.com (Colombia). Funciona sin sesión; con sesión indica si ya te postulaste.
Inputs: palabra (required), fecha, pagina, contrato, +3 more.
comparar-perfilA
Compara tu hoja de vida de elempleo con el perfil maestro y lista lo que falta, lo desactualizado y lo que sobra.
Inputs: no named parameters.
construir-perfil-maestroA
Crea el perfil maestro (fuente única de tus datos para todos los MCP de empleo) cuando aún no existe. Sin argumentos, indica qué pedirle al usuario: la URL de su LinkedIn, o su CV en PDF y su foto. Con un PDF devuelve el texto extraído, el esquema estándar y las reglas para armar el JSON; con solo la URL de LinkedIn explica cómo exportar el perfil a PDF. No guarda nada: eso lo hace guardar-perfil-maestro tras la confirmación del usuario.
Inputs: foto, texto, cv_pdf, desde_portal, +1 more.
detalle-de-ofertaB
Devuelve la descripción completa de una oferta: requisitos, salario, contrato, modalidad y ciudad.
Inputs: id (required).
estado-de-sesionB
Indica si hay una sesión válida de elempleo y el estado de la hoja de vida. Nunca muestra cookies.
Inputs: no named parameters.
evaluar-encajeA
Compara la oferta con el perfil maestro y sus preferencias (modalidad, salario mínimo según tipo de contrato, tecnologías declaradas y nivel de inglés) y devuelve encaja, encaja_parcial o no_encaja con los motivos.
Inputs: id (required).
guardar-perfil-maestroA
Valida el perfil maestro contra el esquema estándar y lo guarda (por defecto en ~/.perfil-maestro/perfil-maestro.json). Copia la foto y el CV junto al perfil. Llamar solo después de que el usuario apruebe el contenido. No sobrescribe uno existente salvo sobrescribir: true (y lo respalda).
Inputs: perfil (required), foto, cv_pdf, sobrescribir.
iniciar-sesionA
Abre un navegador basado en Chromium (Chrome, Edge, Brave o Chromium) en la página de inicio de sesión de elempleo para que el usuario entre a mano (hay reCAPTCHA y verificación en dos pasos). Al detectar la sesión guarda las cookies en la carpeta de datos del MCP y cierra la ventana.
Inputs: espera_max_segundos.
listar-mis-cvB
Lista los archivos de CV adjuntos en elempleo.
Inputs: no named parameters.
mis-postulacionesB
Lista tus postulaciones en elempleo con su estado (en proceso, vencida, eliminada…).
Inputs: pagina, por_pagina.
postular-a-ofertaA
Envía la postulación. Exige confirmación explícita del usuario para ESA oferta: confirmacion debe ser exactamente "POSTULAR ". Una oferta a la vez, sin reintentos automáticos.
Inputs: id (required), confirmacion (required), nota, adjunto_id.
preguntas-de-postulacionA
Lee el formulario de postulación de la oferta (requiere sesión): tipo de postulación, nota opcional, archivos de CV disponibles y formularios adicionales. No envía nada.
Inputs: id (required).
proponer-respuestasB
Redacta la nota al empleador a partir del perfil maestro y señala lo que requiere confirmación del usuario. Nunca inventa datos ni envía nada.
Inputs: id (required).
responder-cuestionarioA
Envía el cuestionario de filtro que la empresa pide tras postular (estado "requiere_cuestionario"). Las respuestas deben venir del usuario o estar confirmadas por él; confirmacion debe ser exactamente "CUESTIONARIO ".
Inputs: id (required), url (required), respuestas (required), confirmacion (required).
subir-cvA
Sube el CV en PDF del perfil maestro (cv_pdf: una ruta, o un objeto con varias versiones) a tus archivos de elempleo; opcionalmente reemplaza uno existente. Sin aplicar solo muestra lo que haría.
Inputs: aplicar, version, reemplazar_id.
subir-fotoA
Sube la foto indicada en datos_personales.foto del perfil maestro (JPG, PNG o GIF, máx. 3 MB). Sin aplicar solo muestra lo que haría.
Inputs: aplicar.
ver-mi-perfilA
Lee tu hoja de vida actual en elempleo: perfil profesional, experiencia, formación, cursos, idiomas, redes, habilidades y archivos.
Inputs: no named parameters.
ver-perfil-maestroB
Muestra el perfil maestro, dónde está, si cumple el esquema estándar y qué queda pendiente de confirmar.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
El conjunto está mayormente bien separado por recurso y acción: buscar/detallar/evaluar/postular ofertas son pasos distintos y las lecturas frente a las escrituras están claramente marcadas ('propone, no envía', 'sin aplicar solo muestra lo que haría'). Los solapamientos menores están entre las herramientas de perfil (ver-perfil-maestro vs ver-mi-perfil vs comparar-perfil) y entre preguntas-de-postulacion y responder-cuestionario, pero las descripciones aclaran cuál corresponde.
Todo usa kebab-case en español, lo que resulta legible, pero se mezclan nombres con verbo (buscar-ofertas, ver-perfil-maestro, subir-cv) y nombres solo con sustantivo (estado-de-sesion, detalle-de-oferta, mis-postulaciones). Además el prefijo posesivo alterna entre 'mi-' y 'mis-' (ver-mi-perfil, mis-postulaciones, listar-mis-cv).
Con 19 herramientas queda en el límite alto, pero el dominio es amplio (sesión, búsqueda, evaluación, postulación, cuestionarios, perfil maestro, hoja de vida y archivos) y casi cada herramienta cubre una operación concreta. La separación entre construir/guardar/ver el perfil maestro y entre actualizar/subir responde a flujos reales distintos, aunque podría comprimirse ligeramente.
El ciclo de vida está bien cubierto, desde el inicio de sesión y la búsqueda hasta la postulación, el cuestionario, el seguimiento y la gestión del perfil y archivos. Faltan operaciones menores como cerrar sesión, retirar una postulación o eliminar un CV, y guardar-perfil-maestro solo sobrescribe en lugar de editar campos existentes.
Related MCP Connectors
Search jobs, tailor your resume, write cover letters, and file applications for you.
Automate your job search: find jobs, upload a resume, apply automatically, and track applications.
Search jobs, review confirmed CV facts and prepare documents with scoped OAuth access.
Job applications done for you: check applications and interviews, get prep, apply to a job by URL.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables natural language management of job applications through MCP-compatible clients, including searching real job offers, creating and deleting applications, generating CVs or cover letters, and retrieving application metrics.ISC
- AlicenseNot gradedqualityBmaintenanceEnables conversational job search on Computrabajo, including reading full job postings, viewing your CV, and applying to jobs with explicit confirmation.43 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables users to search and retrieve job listings and details, and to manage their career profile—including work experiences, job summaries, career goals, and technical skills—through natural language interactions.MIT
- AlicenseBqualityBmaintenanceEnables searching and evaluating job offers on Magneto, preparing questionnaire responses from a master profile, and submitting applications one at a time only after explicit confirmation. It also keeps the candidate profile and CV up to date from a single master profile file.1856 npm2MIT