Remoote Remote Jobs MCP

Official6 toolsLive

by asmisha

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

Topics

ai-agentscareer-toolsjob-searchmcpmodel-context-protocolremote-jobssalary-data

Captured live from the server via tools/list.

search_jobs

Search active Remoote remote jobs. Returns capped public results with canonical Remoote URLs and no raw employer apply URLs.

Parameters10

query	any	optional
skills	any	optional
exclude_skills	any	optional
country	any	optional
region	any	optional
location_tag	any	optional
seniority	any	optional
employment_type	any	optional
salary_required	boolean	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query"
    },
    "skills": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 20,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Skills"
    },
    "exclude_skills": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 20,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exclude Skills"
    },
    "country": {
      "anyOf": [
        {
          "maxLength": 100,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Country"
    },
    "region": {
      "anyOf": [
        {
          "maxLength": 80,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Region"
    },
    "location_tag": {
      "anyOf": [
        {
          "maxLength": 80,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Location Tag"
    },
    "seniority": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/SeniorityLevel"
          },
          "maxItems": 10,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Seniority"
    },
    "employment_type": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/EmploymentType"
          },
          "maxItems": 10,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Employment Type"
    },
    "salary_required": {
      "default": true,
      "title": "Salary Required",
      "type": "boolean"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "$defs": {
    "EmploymentType": {
      "enum": [
        "full-time",
        "part-time",
        "contract",
        "temporary",
        "internship"
      ],
      "title": "EmploymentType",
      "type": "string"
    },
    "SeniorityLevel": {
      "enum": [
        "entry",
        "junior",
        "middle",
        "senior",
        "staff",
        "principal",
        "lead",
        "vp",
        "director",
        "executive",
        "manager"
      ],
      "title": "SeniorityLevel",
      "type": "string"
    }
  },
  "title": "AgentSearchJobsRequest"
}

get_job

Fetch public details for one active Remoote job, including salary, location, skills, excerpts, and a Remoote job URL.

Parameters1

job_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "exclusiveMinimum": 0,
      "title": "Job Id",
      "type": "integer"
    }
  },
  "required": [
    "job_id"
  ],
  "title": "AgentGetJobRequest"
}

get_salary_stats

Return salary stats for active Remoote jobs matching supported filters when enough normalized compensation data exists.

Parameters10

query	any	optional
skills	any	optional
exclude_skills	any	optional
country	any	optional
region	any	optional
location_tag	any	optional
seniority	any	optional
employment_type	any	optional
salary_required	boolean	optional
company_id	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "anyOf": [
        {
          "maxLength": 200,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Query"
    },
    "skills": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 20,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Skills"
    },
    "exclude_skills": {
      "anyOf": [
        {
          "items": {
            "type": "string"
          },
          "maxItems": 20,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Exclude Skills"
    },
    "country": {
      "anyOf": [
        {
          "maxLength": 100,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Country"
    },
    "region": {
      "anyOf": [
        {
          "maxLength": 80,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Region"
    },
    "location_tag": {
      "anyOf": [
        {
          "maxLength": 80,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Location Tag"
    },
    "seniority": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/SeniorityLevel"
          },
          "maxItems": 10,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Seniority"
    },
    "employment_type": {
      "anyOf": [
        {
          "items": {
            "$ref": "#/$defs/EmploymentType"
          },
          "maxItems": 10,
          "type": "array"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Employment Type"
    },
    "salary_required": {
      "default": true,
      "title": "Salary Required",
      "type": "boolean"
    },
    "company_id": {
      "anyOf": [
        {
          "exclusiveMinimum": 0,
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Company Id"
    }
  },
  "$defs": {
    "EmploymentType": {
      "enum": [
        "full-time",
        "part-time",
        "contract",
        "temporary",
        "internship"
      ],
      "title": "EmploymentType",
      "type": "string"
    },
    "SeniorityLevel": {
      "enum": [
        "entry",
        "junior",
        "middle",
        "senior",
        "staff",
        "principal",
        "lead",
        "vp",
        "director",
        "executive",
        "manager"
      ],
      "title": "SeniorityLevel",
      "type": "string"
    }
  },
  "title": "AgentSalaryStatsRequest"
}

get_top_jobs

Return a capped public list of currently popular Remoote remote jobs.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "title": "AgentTopJobsRequest"
}

create_apply_intent

Create a user-confirmed Remoote apply redirect for an authenticated agent token. Requires the apply:intent scope and never returns raw employer apply URLs.

Parameters1

job_id

integer

required

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "exclusiveMinimum": 0,
      "title": "Job Id",
      "type": "integer"
    }
  },
  "required": [
    "job_id"
  ],
  "title": "AgentApplyIntentRequest"
}

create_alert

Create a daily or weekly Remoote job alert for the authenticated user. Requires the alerts:write scope.

Parameters4

name	any	optional
criteria	any	required
frequency	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "anyOf": [
        {
          "maxLength": 120,
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Name"
    },
    "criteria": {
      "$ref": "#/$defs/AgentAlertCriteria"
    },
    "frequency": {
      "default": "daily",
      "enum": [
        "daily",
        "weekly"
      ],
      "title": "Frequency",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "title": "Limit",
      "type": "integer"
    }
  },
  "required": [
    "criteria"
  ],
  "$defs": {
    "AgentAlertCriteria": {
      "properties": {
        "query": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Query"
        },
        "skills": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "maxItems": 20,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Skills"
        },
        "exclude_skills": {
          "anyOf": [
            {
              "items": {
                "type": "string"
              },
              "maxItems": 20,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Exclude Skills"
        },
        "country": {
          "anyOf": [
            {
              "maxLength": 100,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Country"
        },
        "seniority": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/SeniorityLevel"
              },
              "maxItems": 10,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Seniority"
        },
        "employment_type": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/EmploymentType"
              },
              "maxItems": 10,
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Employment Type"
        },
        "salary_required": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Salary Required"
        }
      },
      "title": "AgentAlertCriteria",
      "type": "object"
    },
    "EmploymentType": {
      "enum": [
        "full-time",
        "part-time",
        "contract",
        "temporary",
        "internship"
      ],
      "title": "EmploymentType",
      "type": "string"
    },
    "SeniorityLevel": {
      "enum": [
        "entry",
        "junior",
        "middle",
        "senior",
        "staff",
        "principal",
        "lead",
        "vp",
        "director",
        "executive",
        "manager"
      ],
      "title": "SeniorityLevel",
      "type": "string"
    }
  },
  "title": "AgentCreateAlertRequest"
}

README.md4 KBView on GitHub

Remoote Remote Jobs MCP

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

Website and docs: https://remoote.app/agents
MCP endpoint: https://api.remoote.app/remoote/agents/mcp
Token setup: https://remoote.app/agents/connect

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

Tool	Access	What it does
`search_jobs`	Public or token	Searches active Remoote jobs by query, 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.

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:

http

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

bash

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

bash

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

Expected result: structuredContent.status is ok and each job links back to Remoote instead of exposing a raw employer apply URL.

Create an alert with a token

bash

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.

Install

Tools (6)

search_jobsget_jobget_salary_statsget_top_jobscreate_apply_intentcreate_alert

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.remoote.app/remoote/agents/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "remote-jobs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.remoote.app/remoote/agents/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.