Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Landed

de landedjobsversión 0.3.0i★ 4iSe ejecuta en la nubeSitio oficial ↗
Nombre en el registroio.github.landedjobs/landed

Cómo instalar

What it does

Sign in with landed to search jobs ranked to your résumé and fetch free interview-prep resources.

  • Connects Se ejecuta en la nube
  • Account or key Needs Authorization
  • Category Búsqueda y memoria de IA

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

de google-research★ 35.6381 skills

Skill · Guía de trabajo

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

de BigBodyCobain★ 11.6051 skills

Skill · Guía de trabajo

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

de gosom★ 82361 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad8/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso28/100

Calidad: Pasó 6/6 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Landed. Sigue https://mcp.popnx.com/i/landedjobs-landed.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 6/6 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.landed.jobs) · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 5 min

Necesitas una clave de Landed (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Regístrate y crea una clave de Landed

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Landed ↗

  2. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreLanded
    Remote MCP server URL · Direcciónhttps://mcp.landed.jobs/mcp

    En Request headers, añade este nombre y valor

    Nombre del headerAuthorization
    ValorBearer <pega tu clave aquí>

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  4. Actívalo en un chat

    +ConnectorsLanded

  5. Pruébalo

    Usa Landed y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Landed o muestra una herramienta de Landed en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Landed

Landed necesita tu propia clave para conectarse, pero la ayuda de OpenAI solo describe el inicio de sesión con OAuth; no hay una opción de clave que hayamos podido verificar

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Landed

  • Necesitas una clave de Landed (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
  • Necesitas una clave de Landed (créala en el sitio del autor)
  • Necesitas una clave de Landed (créala en el sitio del autor)
  • Necesitas una clave de Landed (créala en el sitio del autor)

B · Otros en Búsqueda y memoria de IA que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code · unos 5 min

Necesitas una clave de Landed (créala en el sitio del autor)

  1. Regístrate y crea una clave de Landed

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Landed ↗

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user landed https://mcp.landed.jobs/mcp --header 'Authorization: Bearer your-value'

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Escribe /mcp en Claude Code

    Deberías ver Landed en la lista como conectado

  5. Pruébalo

    Usa Landed y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Landed o muestra una herramienta de Landed en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 5 min

Necesitas una clave de Landed (créala en el sitio del autor)

  1. Regístrate y crea una clave de Landed

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Landed ↗

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de Landed, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de Cursor en modo Agent

  5. Pruébalo

    Usa Landed y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Landed o muestra una herramienta de Landed en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 5 min

Necesitas una clave de Landed (créala en el sitio del autor)

  1. Regístrate y crea una clave de Landed

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de Landed ↗

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de Landed, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de VS Code en modo Agent

  5. Pruébalo

    Usa Landed y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Landed o muestra una herramienta de Landed en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://mcp.landed.jobs/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Landed💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user landed https://mcp.landed.jobs/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "landed": {
      "url": "https://mcp.landed.jobs/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "landed": {
      "type": "http",
      "url": "https://mcp.landed.jobs/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Valores que debes completar

  • Authorization secreto HTTP header
    Opcional: un token de API de landed como "Bearer " para clientes sin inicio de sesión OAuth. Puedes crear uno en la configuración de landed.
    Ver original en inglésOptional: a landed API token as "Bearer " for clients without OAuth sign-in. Create one in landed Settings.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en la nube
Transporte
streamable-http
Última versióni
0.3.0
Publicado en el registroi
12 nov 2026
Último cambio de códigoi
17 nov 2026
Última revisión
18 nov 2026
Creador
landedjobs
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 18 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • search_jobs

    Search landed's live job corpus and get a ranked, fit-scored shortlist. Requires a landed API token (Authorization: Bearer ); without one the result is status "sign_in_required" with how to get one. Each search counts against the person's daily search limit for their plan: Free 1

  • get_learning_content

    Get Landed's free learning content to help the user prepare — curated interview-prep repos (real questions, company guides, worked system designs), portfolio-project catalogs, and role roadmaps from the landedjobs GitHub org. Filter by topic, role, and/or category. Always free, f

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub landedjobs, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: anteayer

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 234 ms (HTTP 401)

  • ✓ Superada

    Inicio de sesión con OAuth

    Declara inicio de sesión con OAuth, así que tu app de IA puede llevarte a iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 2 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

La dirección en la nube respondió 4 de las últimas 4 comprobaciones · última 234 ms · revisado 18 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/landedjobs-landed.svg)](https://mcp.popnx.com/en/servers/landedjobs-landed)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Búsqueda y memoria de IAi

  • Más estrellas que el 88% de los otros 6416 servidores de esta categoría
  • Publicado en el registro más recientemente que el 86% de los otros 6416 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 6416 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Landed?

Superó 6 de 6 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: Authorization

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en la nube del creador. Te conectas por internet sin instalar nada, pero lo que envías pasa por los servidores del creador.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez anteayer, y la última versión (0.3.0) llegó al registro hace 7 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

de every-appMuy usado★ 28,3 milActualizado hace 5 días

Se ejecuta en la nube✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

de exa-labsMuy usado★ 5,2 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · exa.aiProbado por el equipo de PopNx

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

de MicrosoftDocsMuy usado★ 2 milActualizado hace 12 meses

Se ejecuta en la nube✓ del servicio · microsoft.comProbado por el equipo de PopNx

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

de proxysoulEn crecimiento★ 1,6 milActualizado hace 2 meses

Se ejecuta en la nube✓ empryo.com

COTAL actions (cotal.ai)

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

de Cotal-AIEn crecimiento★ 401Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · cotal.ai
Comparado con otros parecidos
Este
Landed
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Dónde se ejecutaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoSíSíSíNoNo
Revisiones básicas6/65/52/44/44/44/4
LicenciaMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

Search AI-native jobs and study for interviews — from any MCP client. A public Model Context Protocol server giving Claude, Cursor, VS Code, and any MCP-capable agent live access to Landed's ranked, fit-scored job corpus.

*Maintained by Landed — daily AI-native job matches, agent help with every application, and mock-interview prep.*


What is this?

Landed MCP connects your AI assistant to a curated, continuously-updated corpus of AI-native roles (AI Engineer, ML Engineer, RAG Engineer, AI PM, GTM Engineer, and more). Instead of copy-pasting job boards into a chat, your agent can:

  • 🔎 Search jobs — ranked and fit-scored against a structured brief (role, skills, seniority, remote, compensation, industries…), or from a plain-English description.
  • 📝 Apply in landed — every result links to the job in the landed app, where you apply.
  • 🎓 Study for interviews — fetch free, curated interview-prep, portfolio, and roadmap resources.

It speaks Streamable HTTP and works with any MCP client. Use the hosted server in seconds, or self-host this repo against your own Landed API.

Sign in with landed. Add the server and your AI app opens landed's sign-in; choose Allow and

you're connected. Clients without OAuth can still send a landed API token as Authorization: Bearer .


Quick start (hosted)

The hosted server lives at:

https://mcp.landed.jobs/mcp

Pick your client below. Clients with OAuth (Claude, Claude Code, ChatGPT, Cursor, VS Code) open "Sign in with landed" the first time: sign in, choose Allow, done. You can disconnect any time in landed under Settings → API tokens. The --header / headers lines below are only for clients without OAuth: sign in to landed and create an API token in Settings.

Claude Code

The one-liner (CLI):

claude mcp add --transport http landed-jobs https://mcp.landed.jobs/mcp

Then in a session: /mcp, pick landed and sign in, to confirm it's connected, and try the find_jobs prompt.

Claude Desktop

Open Settings → Developer → Edit Config (this opens claude_desktop_config.json), then add:

{

"mcpServers": { "landed-jobs": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.landed.jobs/mcp", "--header", "Authorization: Bearer lnd_live_your_token_here" ] } } }

Restart Claude Desktop.

Claude Desktop bridges remote HTTP servers through mcp-remote.

If your build has native Custom Connectors (Settings → Connectors → *Add custom connector*), you can

instead paste https://mcp.landed.jobs/mcp directly.

Cursor

Create .cursor/mcp.json in your project (or ~/.cursor/mcp.json globally):

{

"mcpServers": { "landed-jobs": { "url": "https://mcp.landed.jobs/mcp", "headers": { "Authorization": "Bearer lnd_live_your_token_here" } } } }

Then enable landed-jobs under Settings → MCP.

VS Code (GitHub Copilot / Agent Mode)

Create .vscode/mcp.json:

{

"servers": { "landed-jobs": { "type": "http", "url": "https://mcp.landed.jobs/mcp", "headers": { "Authorization": "Bearer lnd_live_your_token_here" } } } }

Open the Chat view → Agent mode → the tools appear under the 🔧 picker.

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{

"mcpServers": { "landed-jobs": { "serverUrl": "https://mcp.landed.jobs/mcp", "headers": { "Authorization": "Bearer lnd_live_your_token_here" } } } }

Cline (VS Code extension)

Open Cline → MCP Servers → Configure, or edit cline_mcp_settings.json:

{

"mcpServers": { "landed-jobs": { "type": "streamableHttp", "url": "https://mcp.landed.jobs/mcp", "headers": { "Authorization": "Bearer lnd_live_your_token_here" } } } }

Gemini CLI

Edit ~/.gemini/settings.json (or .gemini/settings.json in your project):

{

"mcpServers": { "landed-jobs": { "httpUrl": "https://mcp.landed.jobs/mcp", "headers": { "Authorization": "Bearer lnd_live_your_token_here" } } } }

Restart gemini and run /mcp to see the tools.

Any other MCP client

Point it at https://mcp.landed.jobs/mcp using the Streamable HTTP transport and pass Authorization: Bearer . Quick sanity check from a terminal:

curl -s -X POST https://mcp.landed.jobs/mcp \

-H 'content-type: application/json' \ -H 'accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Registries

Landed is listed on the Official MCP Registry as io.github.landedjobs/landed, and on Smithery as landedjobs/landed. Clients that read either registry can discover and install it without any manual configuration.


Tools

ToolWhat it doesAccess
search_jobsRanked, fit-scored jobs, each with a productUrl to the job in the landed app (apply there). Fill the structured fields (role, seniority, locations, remote, skills, minComp); free-text query is matched only as a title.signed in, daily limit by plan
get_learning_contentCurated interview-prep, portfolio, and roadmap resources.signed in

search_jobs returns one of three statuses:

  • ok: jobs (each with jobId, title, company, location, fitLabel, oneLineWhy, productUrl).
  • sign_in_required: the token was not accepted; reconnect landed in your AI app.
  • limit_reached: the day's searches for the plan are used; the result has message, limit and resetsAt.

Prompts (guided workflows)

MCP prompts are reusable, user-invocable skills that teach the agent how to chain the tools and present results as a clean shortlist — never raw JSON. In most clients they show up as slash-commands.

PromptArgsWhat it guides
find_jobsdescribe?Search, then present a ranked, fit-scored shortlist with links to apply in landed.
prep_for_rolerole?Pull learning resources for a role and suggest a study order.

The server also ships always-on instructions (access and limits, tool overview, presentation rules) that compliant clients load automatically.

Location parameters

Location eligibility is structured rather than keyword-matched:

  • locations: physical cities/countries, with country included for ambiguous cities, e.g. ["Bengaluru, India"]
  • countryCodes: ISO alpha-2 remote/base eligibility, e.g. ["IN"]
  • regionCodes: apac, emea, or americas
  • workAuthorizationCountryCodes: ISO alpha-2 work-authorization countries
  • remote: work mode (remote, hybrid, or onsite)

The hosted API resolves human city labels to stable place identities. Callers must not invent place IDs. The legacy regions field remains accepted for compatibility.


Auth & pricing

The server uses OAuth 2.1 (authorization code with PKCE, dynamic client registration). A request with no token gets 401 with WWW-Authenticate: Bearer resource_metadata="https://mcp.landed.jobs/.well-known/oauth-protected-resource", and the client discovers the rest from there:

  • /.well-known/oauth-protected-resource and /.well-known/oauth-authorization-server
  • POST /oauth/register (dynamic client registration), POST /oauth/token (code exchange)
  • the Allow screen at https://app.landed.jobs/oauth/authorize

The token an app receives is an ordinary landed API token, listed in Settings → API tokens. A token you create there by hand works the same way, as Authorization: Bearer lnd_live_…. Privacy: mcp.landed.jobs/privacy.

Each search counts against a daily limit set by your landed plan:

PlanSearches per day
Free10
Plus50
Pro and Max200

At the limit, search_jobs returns limit_reached with when it resets.


Architecture

This repository is a thin, self-hostable proxy. It speaks MCP and forwards to the hosted Landed API — it holds no database, no ranking engine, and no job data.

   MCP client                 landed-mcp (this repo)              Landed API

┌─────────────┐ HTTP ┌────────────────────────┐ HTTPS ┌────────────────────────┐ │ Claude / │ ───────▶ │ • MCP protocol + tools │ ──────▶ │ • search engine │ │ Cursor / │ /mcp │ • forwards caller creds│ │ • job corpus │ │ VS Code … │ ◀─────── │ • local learning list │ ◀────── │ • auth · plan limits │ └─────────────┘ └────────────────────────┘ └────────────────────────┘

The proxy forwards the caller's API token to the Landed API, which validates it, runs the search, counts it against the plan limit, and returns the result. A request without a token is answered by the proxy itself with 401, so it never reaches the API. The get_learning_content catalog is static and lives in this repo (src/mcp/catalog/learning.ts) — that tool works with no backend at all.


Self-host

Run your own proxy against the Landed API (or your own deployment of it).

Prerequisites
  • Node.js ≥ 20
  • pnpm (npm i -g pnpm)
  • A Landed API base URL and its shared internal secret
Run
git clone git@github.com:landedjobs/landed-mcp.git

cd landed-mcp pnpm install cp .env.example .env # then fill in the values below pnpm dev # hot-reload dev server

→ [mcp] listening on :8090 — POST /mcp → https://api.landed.jobs/api/v1

For production: pnpm start.

Stdio and Docker

For clients that start the server as a process, pnpm start:stdio speaks MCP over stdio instead of HTTP. Set LANDED_API_TOKEN to your API token; without it search_jobs answers sign_in_required.

docker build -t landed-mcp .

docker run -i --rm landed-mcp

The image runs the stdio server against the hosted API.

Environment variables
VariableRequiredDefaultDescription
LANDED_API_BASE✓http://localhost:8000/api/v1Hosted Landed API base, including the /api/v1 prefix.
LANDED_INTERNAL_SECRET✓—Shared secret authenticating this proxy to the API (must match the server's INTERNAL_SERVICE_SECRET).
PORT8090HTTP port to listen on.
CORS_ORIGINS*Comma-separated allowlist of origins, or *.
RATE_LIMIT_PER_MIN60Per-IP first-line request cap. Each person's plan search limit is the real economic cap.
LANDED_SIGNUP_URLhttps://app.landed.jobsSign-up link in sign_in_required answers.
Endpoints
MethodPathPurpose
POST/mcpMCP Streamable HTTP endpoint (stateless).

| GET | `/heal

Solo se muestra el principio; lee el resto en el repo