Search 690k open jobs from official ATS feeds, and what changed since your last check.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Bearer <key>. Get a free key with no account: POST https://api.roleset.io/v1/keys with {"accept_terms": true}
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Every open posting at one company. Accepts a domain (acme.com), an ATS board slug, or the company name. Use when the company is already known and you want its roles; use search_jobs when you are looking across companies. For whether the company is growing rather than what it has open, use hiring_signal.
Domain, ATS board slug, or company name.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Every open posting at one company. Accepts a domain (acme.com), an ATS board slug, or the company name. Use when the company is already known and you want its roles; use search_jobs when you are looking across companies. For whether the company is growing rather than what it has open, use hiring_signal.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| identifier* | string | Domain, ATS board slug, or company name. |
| include_description | boolean |
{
"type": "object",
"title": "company_jobs_toolArguments",
"required": [
"identifier"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"maximum": 100,
"minimum": 1
},
"identifier": {
"type": "string",
"title": "Identifier",
"description": "Domain, ATS board slug, or company name."
},
"include_description": {
"type": "boolean",
"title": "Include Description",
"default": false
}
}
}Fetch a single posting by its Roleset id, including the full description text and HTML. Use after search_jobs or job_changes when you need the body of a specific posting — for summarising requirements, or checking whether a role matches a candidate's constraints. The id comes from an earlier result.
| Argument | Type | Description |
|---|---|---|
| job_id* | string | Roleset job id (UUID) from an earlier result. |
{
"type": "object",
"title": "get_job_toolArguments",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"title": "Job Id",
"description": "Roleset job id (UUID) from an earlier result."
}
}
}Whether a company is hiring, and where. Returns open roles broken down by department plus how many opened and closed over the last 7 and 30 days, and the net change. Use for sales and research questions — 'is this company growing', 'are they building out engineering', 'did they stop hiring' — where counts and trend matter more than the individual postings. One call, not per record.
| Argument | Type | Description |
|---|---|---|
| identifier* | string | Domain, ATS board slug, or company name. |
{
"type": "object",
"title": "hiring_signal_toolArguments",
"required": [
"identifier"
],
"properties": {
"identifier": {
"type": "string",
"title": "Identifier",
"description": "Domain, ATS board slug, or company name."
}
}
}What has opened, changed, closed or reopened in the index. This is the tool to poll: pass `since` (ISO-8601) the first time, then keep passing the returned `meta.next_cursor` and you will see each event exactly once, with no gaps or repeats. Filter it the same way you would a search — by department, country, remote, title, company or ATS — to subscribe to one slice of the market. Each event carries the event type, when it happened, a `diff` showing which fields changed and their before/after values, and the job record itself. Use this to track a hiring market over time, to answer 'what's new since yesterday', or to keep a downstream store in sync. Defaults to the last 24 hours.
| Argument | Type | Description |
|---|---|---|
| ats | any | |
| event | any | opened | updated | closed | reopened |
| limit | integer | |
| since | any | ISO-8601; ignored when cursor is set. |
| title | any | Match on the job title. |
| cursor | any | |
| remote | any | Only remote, or only non-remote. |
| company | any | |
| country | any |
Search the index of open job postings. Use for a one-off question about the job market: who is hiring for a role, what is open in a city or country, which companies have remote positions. Returns a page of job records plus a `meta.next_cursor` to continue; each record has title, company, structured locations, remote flag, employment type, salary when the board publishes one, and an apply URL. Descriptions are omitted unless `include_description` is set, because they are large. To find what has *changed* since you last looked, use job_changes instead — do not poll this tool in a loop.
| Argument | Type | Description |
|---|---|---|
| q | any | Free text over title and description. |
| ats | any | Restrict to one ATS platform. |
| limit | integer | |
| title | any | Match on the job title. |
| cursor | any | From a previous meta.next_cursor. |
| remote | any | Only remote, or only non-remote. |
| company | any | Company name, partial match. |
| country | any | ISO-3166 alpha-2, e.g. US, DE. |
| location | any |
Size and freshness of the whole index: companies, boards per ATS, open and total postings, events in the last 24 hours, and when the oldest active board was last crawled. Free. Use to tell a user how much coverage stands behind an answer, or to check the index is current before relying on it.
No arguments.
{
"type": "object",
"title": "stats_toolArguments",
"properties": {}
}| ISO-3166 alpha-2, e.g. US. |
| department | any | Department, partial match. |
| include_job | boolean |
{
"type": "object",
"title": "job_changes_toolArguments",
"properties": {
"ats": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ats",
"default": null
},
"event": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Event",
"default": null,
"description": "opened | updated | closed | reopened"
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"maximum": 100,
"minimum": 1
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Since",
"default": null,
"description": "ISO-8601; ignored when cursor is set."
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Title",
"default": null,
"description": "Match on the job title."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cursor",
"default": null
},
"remote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Remote",
"default": null,
"description": "Only remote, or only non-remote."
},
"company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Company",
"default": null
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country",
"default": null,
"description": "ISO-3166 alpha-2, e.g. US."
},
"department": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Department",
"default": null,
"description": "Department, partial match."
},
"include_job": {
"type": "boolean",
"title": "Include Job",
"default": true
}
}
}| City or region. |
| department | any |
| posted_after | any | ISO-8601 timestamp. |
| employment_type | any | full_time | part_time | contract | intern | temporary | volunteer |
| listed_since_after | any | ISO-8601. When the company last put the role on the market — it moves when a posting is reopened, so this is the filter for what is on the market now. |
| include_description | boolean |
{
"type": "object",
"title": "search_jobs_toolArguments",
"properties": {
"q": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Q",
"default": null,
"description": "Free text over title and description."
},
"ats": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Ats",
"default": null,
"description": "Restrict to one ATS platform."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25,
"maximum": 100,
"minimum": 1
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Title",
"default": null,
"description": "Match on the job title."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cursor",
"default": null,
"description": "From a previous meta.next_cursor."
},
"remote": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"title": "Remote",
"default": null,
"description": "Only remote, or only non-remote."
},
"company": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Company",
"default": null,
"description": "Company name, partial match."
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Country",
"default": null,
"description": "ISO-3166 alpha-2, e.g. US, DE."
},
"location": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Location",
"default": null,
"description": "City or region."
},
"department": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Department",
"default": null
},
"posted_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Posted After",
"default": null,
"description": "ISO-8601 timestamp."
},
"employment_type": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Employment Type",
"default": null,
"description": "full_time | part_time | contract | intern | temporary | volunteer"
},
"listed_since_after": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Listed Since After",
"default": null,
"description": "ISO-8601. When the company last put the role on the market — it moves when a posting is reopened, so this is the filter for what is on the market now."
},
"include_description": {
"type": "boolean",
"title": "Include Description",
"default": false
}
}
}