HiddenJobs — Remote Tech Job Search MCP server

Job Search MCP

Find remote technology jobs with MCP. Connect Claude, Cursor, or any AI agent to search roles, filter opportunities, read full descriptions, compare jobs, and find where to apply over Streamable HTTP.

The server lets an agent discover relevant roles, read complete job descriptions, compare opportunities, and retrieve the original application URL when the account has the required access subscription.

Find remote tech jobs · Read the live MCP documentation · Read the live REST API docs · Browse repository docs

Need direct REST access instead? Use the Job Search API.

Your job-search copilot

Use natural language to discover roles that match your skills and preferences, then go deeper only when a listing is worth your time:

• Search by role, technology, company, location, schedule, or employment type
• Read full descriptions and structured job metadata
• Compare shortlisted roles with an AI assistant
• Request the original application link when your access allows it

Hosted server

Use the hosted MCP endpoint:

https://api.hiddenjobs.dev/mcp

Create an access key from the developer dashboard, then add the endpoint and the key to your MCP client. The bearer token is forwarded to the job search API and is never replaced with a Supabase credential.

Capabilities

Search and job-detail responses intentionally omit url, applicationurl, and sourceurl. They expose hasApplicationLink instead. The original URL is returned only by openapplicationlink after the API checks the key scope and the account subscription.

There is no auto-apply tool.

Quick start

1. Create an access key

Create an access key with the jobs:read and application-links:read scopes. The dashboard shows the full key only once. Store it in your client's secret configuration.

2. Configure your MCP client

The configuration is the same for the hosted server and a self-hosted deployment. Replace the placeholder with your own key without committing it.

{
  "mcpServers": {
    "remote-jobs": {
      "url": "https://api.hiddenjobs.dev/mcp",
      "headers": {
        "Authorization": "Bearer hj_live_..."
      }
    }
  }
}

Ready-to-copy examples for common clients are in examples/.

3. Ask your client

Try a request such as:

Find remote TypeScript jobs in Europe and summarize the three best matches.

The client should call searchjobs, then call getjob for the offers it wants to inspect. It should call openapplicationlink only when the user asks to apply and the account has an active subscription.

Architecture

flowchart LR
    Client[MCP client] -->|JSON-RPC over HTTPS\nBearer access key| MCP[Remote Jobs MCP]
    MCP -->|Forward bearer token| API[Job Search REST API]
    API --> Auth{API key and scope}
    Auth -->|jobs:read| Jobs[(Public job data)]
    Auth -->|application-links:read| Subscription{Active subscription?}
    Subscription -->|Yes| Link[Original application URL]
    Subscription -->|No| Denied[402 subscription_required]

Shortened. The full README is on GitHub.