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.
| Tool | Access | What it does |
|---|
search_jobs | Public or token | Searches active Remoote jobs by role title, broader posting keywords, skills, location filters, seniority, employment type, and salary visibility. |
get_job | Public or token | Returns public details for one active job, including salary fields, location rules, skills, excerpts, and the Remoote job URL. |
get_salary_stats | Public or token | Returns salary stats for matching jobs when enough normalized compensation data is available. |
get_top_jobs | Public or token | Returns a capped list of currently popular remote jobs. |
create_apply_intent | Token required | Creates a Remoote apply redirect for an authenticated user after the agent asks for confirmation. |
create_alert | Token required | Creates 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.
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
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.