Remote jobs.
Meet your
assistant.

01 / Connection

One URL to get started.

In a client that supports remote MCP servers, add an HTTP server named RemoteJobs and paste this endpoint. Choose Streamable HTTP. Public catalog searches need no authentication. To use private Career Agent tools, connect your account through the authorization page your client opens.

https://remotejobs.org/mcp

Configuration example

Clients use different configuration formats. This mcpServers example works in clients that accept type: "http"; consult your client’s documentation for its exact format.

{
  "mcpServers": {
    "remotejobs": {
      "type": "http",
      "url": "https://remotejobs.org/mcp"
    }
  }
}

Use the RemoteJobs.org endpoint above. The JSON API lives at a separate URL: see the API guide.

02 / Tools

Discover, then read the details.

Discover with a structured request

Discovery returns jobs, next_cursor, previous_cursor, total: { kind: "unknown" }, and coverage. Stop when next_cursor is null. This exhausts the retained result window, not the entire matching catalog.

Read selected posting sections

Call get_job with one returned id and the sections you need. Its structured payload is bounded to 32 KiB. For a continued Markdown description, pass its next_cursor with the same id and sections. Join description text in order; the returned offsets count Unicode code points, and complete identifies the final part.

Cursors expire after ten minutes. If a discovery or detail call reports status 409 (results changed) or 410 (expired), restart without a cursor. Errors appear as isError: true with structured error.status; they are not empty results. The existing search_jobs tool uses the v1 query arguments and response fields, including limit and offset.

03 / Career Agent

Your account, with your permission.

Career Agent tools use the same server URL. A client with OAuth support opens your private account to request permission. Review its identity, callback address, and requested access before connecting. You can revoke it from Connected apps.

Connected tools can read your access and profile, propose fact corrections, find matches, prepare and update applications, request your review, follow operations, and cancel pending work. Preparation and submission require current Career Agent access and processing allowance. Review the offer and supported forms.

You approve the facts and the exact application on RemoteJobs. A tool cannot confirm facts or approve its own submission. Your approval identifies the connected client, employer, materials, and answers. An uncertain outcome is never permission to send another application.

Use the server’s tool discovery for current argument schemas. Every mutation needs a stable idempotency key. Keep the same key when retrying an ambiguous response, and read the returned operation before attempting anything else.

04 / First search

Ask for something concrete.

Try: “Use RemoteJobs to find five React roles in programming. Include company names, locations, and listing links.” Your client discovers the tools and decides which calls to make.

Review the listing before applying. Remote can still mean a specific country or time zone. Salary and location may be missing. Public search provides listings and links. Private Career Agent submission is a separate authorized workflow.

Build your own MCP client

Install @modelcontextprotocol/sdk in your Node.js project, then connect with its Streamable HTTP transport.

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-job-tool", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(
  new URL("https://remotejobs.org/mcp")
));

try {
  const search = { text: "react", filters: { category: "programming" } };
  const result = await client.callTool({
    name: "discover_jobs", arguments: { search, take: 5 }
  });
  if (result.isError) throw new Error(JSON.stringify(result.content));
  const page = result.structuredContent;
  console.log(page.jobs); // Compact summaries; total.kind is "unknown".

  if (page.next_cursor) {
    const next = await client.callTool({
      name: "discover_jobs",
      arguments: { search, take: 5, cursor: page.next_cursor }
    });
    if (next.isError) throw new Error(JSON.stringify(next.content));
    console.log(next.structuredContent.jobs);
  }

  if (page.jobs.length) {
    const detail = await client.callTool({
      name: "get_job",
      arguments: { id: page.jobs[0].id, sections: ["summary", "description"] }
    });
    if (detail.isError) throw new Error(JSON.stringify(detail.content));
    console.log(detail.structuredContent);
  }
} finally {
  await client.close();
}

05 / Limits & behavior

Keep the connection simple.

Keep listing links intact and credit RemoteJobs.org when displaying results. Our terms of service apply to both interfaces.