mcp-magneto
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-magneto busca ofertas de desarrollador backend en Bogotá y evalúa si encajan con mi perfil"
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-magneto
Servidor MCP para Magneto (magneto365.com, Colombia). Con él puedes:
Buscar ofertas, ver su detalle y evaluar si encajan con tu perfil.
Responder el cuestionario de filtro y 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 candidato de Magneto. 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 Magneto.
Proyecto no oficial. No está afiliado a Magneto ni respaldado por ella. Usa la API interna que consume su web, que puede cambiar sin aviso y romper alguna herramienta. Cada quien es responsable de usarlo de acuerdo con los términos de uso de Magneto. Las postulaciones son reales y no se pueden deshacer.
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": {
"magneto": {
"command": "npx",
"args": ["-y", "mcp-magneto"],
"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-magneto.git
cd mcp-magneto
npm instally usar "command": "node" con "args": ["/ruta/a/mcp-magneto/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 (token), 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 ~/.magneto/, fuera de carpetas sincronizadas. El MCP nunca muestra tokens, cookies ni credenciales.
Related MCP server: jobfinder-mcp
Primeros pasos
iniciar-sesion: abre el navegador en el login de Magneto. Entras a mano (código por correo, Google, Microsoft o LinkedIn) y el MCP guarda el token. El token dura 24 horas; como el navegador del MCP conserva tu sesión, volver a llamar ainiciar-sesionla renueva sola en unos segundos.Si aún no tienes perfil maestro,
construir-perfil-maestrote pide una fuente: la URL de tu LinkedIn, tu CV en PDF con tu foto, o lo que ya tienes en Magneto (desde_portal: true). Cuando lo apruebes,guardar-perfil-maestrolo valida y lo guarda.comparar-perfil: muestra qué falta, qué está desactualizado y qué sobra en Magneto frente al perfil maestro.actualizar-perfilpor sección: primero sinaplicar, para ver el plan antes → después; luego conaplicar: true.
Flujo de postulación
buscar-ofertas→detalle-de-oferta→evaluar-encaje.preguntas-de-postulacion: indica si ya estás postulado y lista las preguntas del cuestionario de filtro (todas obligatorias).proponer-respuestas: propone respuestas con el perfil maestro y las clasifica enrespaldada,requiere_confirmacionosin_respaldo. Las dos últimas se resuelven con el usuario: nunca se inventan.postular-a-ofertaconconfirmacion: "POSTULAR <id>"y las respuestas aprobadas. En Magneto el cuestionario y la postulación van en la misma petición.
Estados de respuesta: submitted, already_applied, needs_review (cuestionario incompleto, datos extra exigidos o postulación que quedó como preseleccionada por perfil incompleto), expired, sesion_expirada, limite_de_peticiones y error.
Herramientas
Herramienta | Qué hace |
| Sesión |
| Búsqueda (sin sesión; con sesión indica si ya te postulaste) |
| Compara la oferta con tus preferencias (modalidad, salario según contrato, tecnologías declaradas e inglés) |
| Lee el cuestionario de filtro y propone respuestas con datos del perfil maestro |
| Exige |
| Tus procesos en Magneto |
| Herramientas estándar del perfil maestro |
| Hoja de vida. Secciones: |
| Foto y CV (Magneto guarda un solo CV) |
Las ofertas se identifican por id, slug (desarrollador-backend-1088350) o URL. Sin sesión, Magneto solo da el detalle con el slug.
Toda escritura respalda antes lo que había (en ~/.magneto/respaldos/) y solo borra los ids que pases en eliminar_ids. La sección preferencias cambia cargo, salario mínimo, remoto, híbrido, viajar y cambio de domicilio; el resto del formulario (sector, nivel de estudios, ciudad, jornadas) se reenvía tal como está. Datos personales, ciudad de cada experiencia y "abierto a ofertas" se editan en la web.
Perfil maestro
Campos que usa Magneto (ver perfil-maestro.ejemplo.json):
Campo | Uso |
| Descripción del perfil (máx. 2.000 caracteres). Para fijar otra, usa |
|
|
|
|
|
|
| Habilidades (Magneto admite 10) |
|
|
|
|
|
|
| Cargo en el que buscas empleo (Preferencias de Magneto) |
| Respuestas reutilizables: se proponen cuando su clave o su texto coinciden con la pregunta |
| Foto (JPG o PNG) y CV en PDF |
Perfiles de cualquier área
El MCP no asume una profesión. Probado con perfiles de desarrollo, auxiliar contable (presencial) y ejecutivo comercial (híbrido):
buscar-ofertassinmodalidadusa la del perfil: "Solo remoto" filtra remoto; presencial o híbrido sin reubicación busca en tu ciudad.evaluar-encajerevisa ciudad (presencial o híbrida en otra ciudad), salario según contrato, inglés y, si el perfil declara 3 o más tecnologías de software, el stack; en los demás perfiles busca tus habilidades y herramientas en la descripción.proponer-respuestasresponde experiencia con tu cargo y tus años (y elige la opción de rango que corresponde, p. ej. "Más de 3 años"), compara mínimos en meses en preguntas sí/no, y usa tu formación y habilidades en preguntas de título o conocimientos. Lo que el perfil no sabe (vehículo, licencia, disponibilidad de turnos…) quedasin_respaldo; agrégalo enrespuestas_frecuentescon claves de dos o más palabras (p. ej."licencia_conduccion": "Sí, B1 vigente").
Límite: solo Colombia (búsqueda en C47, salarios en COP).
Referencia técnica
Magneto no tiene API pública para candidatos; la web usa https://api.magneto365.com con un JWT en Authorization: Bearer (cookie access_token de .magneto365.com, válida 24 h). Las lecturas se reintentan una vez si hay 429; los envíos nunca.
Ofertas (/jobs)
Uso | Endpoint |
Búsqueda pública / con sesión |
|
Detalle público (slug) / con sesión (id) |
|
Ubicaciones |
|
Cuestionario |
|
Postular |
|
Mis procesos |
|
Datos extra exigidos |
|
Parámetros de búsqueda: paginator[page], paginator[pageSize] (20 o 30), filters[locations][0], filters[work_modality][0] (remote, hybrid, onSite), filters[contract_type_id][0] (1 fijo, 2 indefinido, 3 temporal, 4 obra o labor, 5 prestación de servicios, 6 aprendizaje), order[field] (_score o publish_date), queries[0][field]=all, queries[0][term].
Respuestas del cuestionario: questionnaires: [{id, questions: [{id, type, openAnswer} | {id, type, answer: [{id, titleAnswer}]}]}]. Tipos: 0 opción única, 1 opción múltiple, 2 texto corto (140), 3 texto largo (2.500). Si la respuesta trae applicationId, la postulación quedó enviada; si trae level y missingFields, quedó preseleccionada por perfil incompleto.
Hoja de vida (/sign-up)
Lectura: GET /sign-up/v2/candidate/profile. Escritura: PATCH /sign-up/v2/candidate con {...sección, step} y la cabecera x-schema-response: profile-v2.
Sección |
| Cuerpo |
Descripción | 15 |
|
Habilidades | 16 |
|
Foto | 19 |
|
Idiomas | 20 |
|
Experiencia | 37 / borrar 63 |
|
Preferencias | 47 |
|
Certificaciones | 60 / borrar 67 |
|
Redes y enlaces / hobbies | 24 / 25 |
|
Formación | 76 / borrar 77 |
|
Niveles de idiomas y habilidades: 1 básico, 2 intermedio, 3 avanzado, 4 profesional o nativo. Fechas AAAA-MM-DD. CV: PUT /sign-up/v1/candidate/upload-cv (multipart, campo file).
Pendiente de verificar
La subida de foto sale del código de la web, pero aún no se ha probado contra una cuenta real (el CV y las secciones de la hoja de vida sí).
Ofertas con
templateId(datos extra del registro), preguntas de opción múltiple y de texto largo.Borrar experiencias, estudios o certificaciones (
eliminar_ids).
Available Tools
18 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 ~/.magneto/respaldos/ y guarda. Solo borra los ids indicados en eliminar_ids.
Inputs: seccion (required), aplicar, eliminar_ids.
buscar-ofertasA
Busca ofertas en Magneto (magneto365.com, Colombia). Funciona sin sesión; con sesión indica si ya te postulaste. Magneto no publica la modalidad por oferta: el filtro de modalidad es del portal y en el detalle se infiere del texto.
Inputs: orden, ciudad, pagina, palabra, +4 more.
comparar-perfilA
Compara tu hoja de vida de Magneto con el perfil maestro y lista lo que falta, lo desactualizado, lo que sobra y lo que conviene corregir en la web.
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-ofertaA
Devuelve la descripción completa de una oferta: requisitos, habilidades, salario, contrato, modalidad inferida, ciudad y si tiene cuestionario de filtro.
Inputs: oferta (required).
estado-de-sesionA
Indica si hay una sesión vigente de Magneto (el token dura 24 h) y el estado de la hoja de vida. Nunca muestra tokens ni cookies.
Inputs: no named parameters.
evaluar-encajeB
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: oferta (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 el login de Magneto para que el usuario entre a mano (código por correo, Google, Microsoft o LinkedIn). Si el navegador del MCP ya tenía la sesión, se renueva sola en segundos. Guarda el token en la carpeta de datos del MCP y cierra la ventana.
Inputs: espera_max_segundos.
listar-mis-cvB
Muestra el CV adjunto en Magneto.
Inputs: no named parameters.
mis-postulacionesC
Lista tus procesos (postulaciones) en Magneto con su estado.
Inputs: pagina.
postular-a-ofertaB
Envía la postulación con las respuestas del cuestionario (si lo hay) en una sola petición. Exige la confirmación explícita del usuario para ESA oferta: confirmacion debe ser exactamente "POSTULAR ". Una oferta a la vez, sin reintentos automáticos.
Inputs: oferta (required), confirmacion (required), respuestas.
preguntas-de-postulacionA
Lee cómo se postula a la oferta (requiere sesión): si ya estás postulado, si exige datos extra y las preguntas del cuestionario de filtro con sus opciones y límites. No envía nada.
Inputs: oferta (required).
proponer-respuestasA
Propone respuestas al cuestionario de filtro a partir del perfil maestro y las clasifica (respaldada, requiere_confirmacion, sin_respaldo). Nunca inventa datos ni envía nada.
Inputs: oferta (required).
subir-cvA
Sube el CV en PDF del perfil maestro (cv_pdf: una ruta, o un objeto con varias versiones). Magneto guarda un solo CV: reemplaza el actual. Sin aplicar solo muestra lo que haría.
Inputs: aplicar, version.
subir-fotoA
Sube la foto indicada en datos_personales.foto del perfil maestro (JPG o PNG, máx. 5 MB) como foto de perfil. Sin aplicar solo muestra lo que haría.
Inputs: aplicar.
ver-mi-perfilA
Lee tu hoja de vida actual en Magneto: descripción, experiencia, formación, habilidades, idiomas, disponibilidad, foto y CV.
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 18 tools
Each tool maps to a distinct step in the job-search workflow (search, evaluate, apply) or profile lifecycle (build, save, view, compare, update). A few pairs need care — ver-perfil-maestro vs. ver-mi-perfil vs. listar-mis-cv, and construir-perfil-maestro vs. guardar-perfil-maestro — but the descriptions clearly separate them.
All names are kebab-case Spanish, which keeps things readable, but the convention mixes verb-first (buscar-ofertas, postular-a-oferta, subir-cv) with noun-first (mis-postulaciones, estado-de-sesion, detalle-de-oferta, preguntas-de-postulacion). The inconsistency is stylistic rather than confusing.
18 tools is slightly above the comfortable range, but the surface spans auth/session, search, evaluation, application, and a full profile lifecycle, so most tools earn their place. No obviously redundant tool is present.
The workflow covers login, listing applications, searching, evaluating fit, answering questionnaires, submitting applications, and full profile create/validate/upload. Minor gaps: no logout/session-close tool, no way to inspect or withdraw a submitted application, and no delete of master profile.
Related MCP Connectors
Search jobs, prepare resumes and cover letters, retrieve PDFs, and track your applications.
Find jobs, then get a tailored résumé and cover letter for each one. Tracks your applications too.
Automate your job search: find jobs, upload a resume, apply automatically, and track applications.
Job applications done for you: check applications and interviews, get prep, apply to a job by URL.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables to interact with job application workflows through MCP, allowing users to find jobs, generate non-trivial applications with proof-maps, and build offline dashboards, all without auto-submitting.Apache 2.0
- FlicenseAqualityDmaintenanceEnables searching job listings, tracking applications, managing resumes, and tailoring resumes to job posts, all locally via MCP.20-
- 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 an AI agent to research industries and companies, track job postings and deadlines from recruiting sites and spreadsheets, match roles against a personal profile, manage application stages, and fill in application forms up to but not including submission. All data stays in a local folder on the user's machine, with reversible actions and confirmation cards for consequential steps.1MIT