Search DevTools

Jump to any tool or page

Remoote Remote Jobs MCP

Search remote jobs, compare salaries, create alerts, and request user-confirmed apply links.

asmisha0 stars0 forksAI & Agents
View source

Install

mcp_config.json

{
  "mcpServers": {
    "app-remoote-remote-jobs": {
      "url": "https://api.remoote.app/remoote/agents/mcp",
      "type": "streamable-http"
    }
  }
}

Documentation

Remoote Remote Jobs MCP

This is the public metadata and docs repository for Remoote Remote Jobs MCP.

Remoote MCP gives agents a structured way to search current remote jobs, read job details, compare salary stats, show popular roles, create job alerts, and request user-confirmed apply redirects. It is meant for agent builders who need job data without scraping pages or exposing raw employer application links.

Tools

ToolAccessWhat it does
search_jobsPublic or tokenSearches active Remoote jobs by role title, broader posting keywords, skills, location filters, seniority, employment type, and salary visibility.
get_jobPublic or tokenReturns public details for one active job, including salary fields, location rules, skills, excerpts, and the Remoote job URL.
get_salary_statsPublic or tokenReturns salary stats for matching jobs when enough normalized compensation data is available.
get_top_jobsPublic or tokenReturns a capped list of currently popular remote jobs.
create_apply_intentToken requiredCreates a Remoote apply redirect for an authenticated user after the agent asks for confirmation.
create_alertToken requiredCreates a daily or weekly Remoote job alert for the authenticated user.

Job search fields

Use role_title for the role or job title the user wants, such as backend engineer. It matches job titles only. Use query for broader keywords that may appear elsewhere in the posting, such as python or postgresql. The two fields can be combined.

MCP job searches may return total_available: null because the endpoint avoids an expensive exact count. result_count is always the number of jobs returned in the current response.

Public vs. token-authenticated behavior

Public calls are available without a token for discovery and read-only job research. They are capped and return public Remoote fields, canonical Remoote URLs, and safe next actions.

Token-authenticated calls use a user-created bearer token. Use them only when the agent needs account-tied workflows such as alerts or apply intents. Create or revoke a token at https://remoote.app/agents/connect, then pass it as:

Authorization: Bearer rma_...

Only grant the scopes your workflow needs.

Apply safety

Public responses do not include raw employer apply URLs. They point users back to Remoote job pages.

create_apply_intent also returns a Remoote redirect, not a raw employer URL. The agent should ask the user to confirm before opening it, because opening the redirect may count as an application redirect or entitlement check.

Quick curl examples

All examples call the remote MCP endpoint directly over JSON-RPC.

List tools

curl -sS \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}' \
  https://api.remoote.app/remoote/agents/mcp

Expected result: tools includes search_jobs, get_job, get_salary_stats, get_top_jobs, create_apply_intent, and create_alert.

Search public jobs

curl -sS \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_jobs","arguments":{"role_title":"backend engineer","query":"python","limit":3,"salary_required":false}}}' \
  https://api.remoote.app/remoote/agents/mcp

Expected result: structuredContent.status is ok, result_count matches the jobs returned, and each job links back to Remoote instead of exposing a raw employer apply URL. total_available may be null.

Create an alert with a token

export REMOOTE_AGENT_TOKEN='rma_...'

curl -sS \
  -H 'content-type: application/json' \
  -H "Authorization: Bearer $REMOOTE_AGENT_TOKEN" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"create_alert","arguments":{"name":"Python remote jobs","criteria":{"query":"python","salary_required":true},"frequency":"daily","limit":10}}}' \
  https://api.remoote.app/remoote/agents/mcp

Use a placeholder like rma_... in examples. Do not put real tokens in docs, logs, or prompts.

More examples

Registry metadata

server.json is prepared for MCP directories and registries. The repository URL points to the intended future public GitHub location: https://github.com/asmisha/remoote-mcp.

Sourced from the repository README.

More in AI & Agents