Jobven

npx add-mcp 'https://api.jobven.com/mcp'

Usa Jobven en Claude Code, Cursor, VS Code y Codex

Busca empleos y empresas de Jobven desde tu asistente de codificación con el servidor MCP de Jobven, recibe cada búsqueda de vuelta como una solicitud REST y prueba un receptor de webhook contra una entrega de muestra firmada.

El servidor MCP de Jobven permite que tu asistente de codificación busque empleos y empresas de Jobven con tu clave de API. Cada resultado incluye la solicitud REST que lo produjo, como una URL y un comando curl, para que una búsqueda que pruebes en el chat vaya directamente a tu código.

URL	https://api.jobven.com/mcp
Transporte	HTTP transmisible
Autenticación	Tu clave de API de Jobven en el encabezado X-API-Key (obtén una clave gratuita); webhook_example funciona sin una
Medición	Igual que la API: cada empleo devuelto cuenta para tu asignación mensual

Conecta tu asistente

Coloca tu clave en una variable de entorno y luego agrega el servidor con un comando:

export JOBVEN_API_KEY="your-api-key"

claude mcp add --transport http --scope user jobven https://api.jobven.com/mcp --header 'X-API-Key: ${JOBVEN_API_KEY}'

• Claude Code almacena ${JOBVEN_API_KEY} por sí mismo y lee la variable cada vez que inicia, en cada proyecto (--scope user).
• Codex almacena el nombre de la variable y envía la clave como Authorization: Bearer, que Jobven acepta.
• VS Code guarda el valor de la clave en tu perfil de usuario de VS Code.
• Cursor no tiene comando de instalación: agrega la configuración de Cursor a continuación a ~/.cursor/mcp.json para cada proyecto, o .cursor/mcp.json para uno solo.

O agrégalo a un archivo de configuración

Para compartir la configuración con un equipo en el repositorio, usa un archivo de configuración. Cada uno lee la clave de la variable de entorno JOBVEN_API_KEY o de un mensaje, por lo que el archivo no contiene claves y es seguro de confirmar.

{
  "mcpServers": {
    "jobven": {
      "type": "http",
      "url": "https://api.jobven.com/mcp",
      "headers": {
        "X-API-Key": "${JOBVEN_API_KEY}"
      }
    }
  }
}

Luego pregúntale a tu asistente algo como "encuentra empleos remotos de TypeScript publicados esta semana y muéstrame la solicitud".

Herramientas

Herramienta	Qué devuelve	Cuenta para tu asignación
search_jobs	Empleos que coinciden con los filtros de GET /v1/public/jobs, 10 por página de forma predeterminada y como máximo 25, cada uno con un extracto en texto plano de su descripción, más nextCursor para la siguiente página	Cada empleo devuelto
get_job	Un empleo por id con su descripción completa, como texto plano o markdown	Un empleo
search_companies	Empleadores que coinciden con los filtros de GET /v1/public/companies	No
get_company	Un empleador por id	No
webhook_example	Una entrega de muestra firmada para job.created, job.updated, job.closed o job.deleted, con un verificador de firmas en TypeScript, Python o Go	No

Cada herramienta es de solo lectura. Ninguna crea, cambia ni elimina nada en tu cuenta.

La solicitud detrás de cada resultado

search_jobs, get_job, search_companies y get_company devuelven cada una un request con la llamada exacta que realizaron:

{
  "method": "GET",
  "url": "https://api.jobven.com/v1/public/jobs?q=engineer&remoteType=remote&limit=10&descriptionFormat=plain",
  "curl": "curl -H \"x-api-key: $JOBVEN_API_KEY\" 'https://api.jobven.com/v1/public/jobs?q=engineer&remoteType=remote&limit=10&descriptionFormat=plain'"
}

El comando curl lee tu clave de $JOBVEN_API_KEY. Tu clave nunca aparece en un resultado de herramienta.

search_jobs solicita descripciones en texto plano y devuelve un extracto de cada una, para que una página de empleos se mantenga pequeña en el contexto de tu asistente. En tu propio código, elimina descriptionFormat=plain para HTML, o usa markdown o all, y aumenta limit al tamaño de página de tu plan (25 en Free, 50 en Starter, 100 en Growth y superiores).

Probando un receptor de webhook

webhook_example devuelve una entrega exactamente como tu endpoint la recibe: el cuerpo sin procesar, cada encabezado y un Jobven-Signature firmado con un secreto de ejemplo. El verificador que devuelve es el de Verificación de firmas, y acepta la muestra durante 300 segundos, para que puedas enviar la muestra por POST a tu receptor y verificarla de extremo a extremo. Las entregas reales están firmadas con el secreto de firma propio de tu suscripción, que se muestra una vez cuando creas la suscripción en el panel.

Uso y límites

Las llamadas MCP pasan por la misma API que tu código: las mismas verificaciones de clave, límite de ráfaga, asignación mensual y conteos de uso en tu panel.

Cuando se rechaza una llamada, la herramienta devuelve el mensaje propio de la API para que tu asistente pueda explicarlo:

El mensaje comienza con	Significado
This tool needs a Jobven API key	La conexión no envió ningún encabezado X-API-Key. Verifica la variable de entorno que lee tu configuración.
Jobven API 401	La clave es desconocida o revocada. Crea una nueva en la página de Claves de API.
Jobven API 429	La asignación mensual se agotó, o se alcanzó el límite de ráfaga. El mensaje indica cuándo reintentar. Consulta Límites de velocidad.

Listar las herramientas y webhook_example no requieren clave, por lo que puedes probar el servidor, y los directorios e inspectores pueden ver lo que ofrece, antes de registrarte.

[

Apify y RapidAPI

Obtén datos de empleos de Jobven a través de Apify o RapidAPI y paga en la cuenta del mercado que ya tienes. Los mismos empleos de los sitios de carrera de los empleadores que la API.

](https://jobven.com/docs/marketplaces)