Servidor MCP

Roleset — job postings index

io.roleset/jobs
Negocio y operaciones Público y accesible MCP 2025-11-25

Qué hace este MCP

Searches and monitors open job postings, company hiring activity, job changes, and index coverage.

company_jobs
Jobs at one company
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.
Esquema de entrada
{'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}}}
Esquema de salida
{'type': 'object', 'title': 'company_jobs_toolDictOutput', 'additionalProperties': True}
get_job
Get one job
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.
Esquema de entrada
{'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.'}}}
Esquema de salida
{'type': 'object', 'title': 'get_job_toolDictOutput', 'additionalProperties': True}
hiring_signal
Company hiring signal
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.
Esquema de entrada
{'type': 'object', 'title': 'hiring_signal_toolArguments', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string', 'title': 'Identifier', 'description': 'Domain, ATS board slug, or company name.'}}}
Esquema de salida
{'type': 'object', 'title': 'hiring_signal_toolDictOutput', 'additionalProperties': True}
job_changes
Job changes since a cursor
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.
Esquema de entrada
{'type': 'object', 'title': 'job_changes_toolArguments', 'properties': {'ats': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ats', 'default': None}, 'event': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Event', 'default': None, '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': None, 'description': 'ISO-8601; ignored when cursor is set.'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Title', 'default': None, 'description': 'Match on the job title.'}, 'cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Cursor', 'default': None}, 'remote': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'title': 'Remote', 'default': None, 'description': 'Only remote, or only non-remote.'}, 'company': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Company', 'default': None}, 'country': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Country', 'default': None, 'description': 'ISO-3166 alpha-2, e.g. US.'}, 'department': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Department', 'default': None, 'description': 'Department, partial match.'}, 'include_job': {'type': 'boolean', 'title': 'Include Job', 'default': True}}}
Esquema de salida
{'type': 'object', 'title': 'job_changes_toolDictOutput', 'additionalProperties': True}
search_jobs
Search jobs
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.
Esquema de entrada
{'type': 'object', 'title': 'search_jobs_toolArguments', 'properties': {'q': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Q', 'default': None, 'description': 'Free text over title and description.'}, 'ats': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Ats', 'default': None, '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': None, 'description': 'Match on the job title.'}, 'cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Cursor', 'default': None, 'description': 'From a previous meta.next_cursor.'}, 'remote': {'anyOf': [{'type': 'boolean'}, {'type': 'null'}], 'title': 'Remote', 'default': None, 'description': 'Only remote, or only non-remote.'}, 'company': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Company', 'default': None, 'description': 'Company name, partial match.'}, 'country': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Country', 'default': None, 'description': 'ISO-3166 alpha-2, e.g. US, DE.'}, 'location': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Location', 'default': None, 'description': 'City or region.'}, 'department': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Department', 'default': None}, 'posted_after': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Posted After', 'default': None, 'description': 'ISO-8601 timestamp.'}, 'employment_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Employment Type', 'default': None, 'description': 'full_time | part_time | contract | intern | temporary | volunteer'}, 'listed_since_after': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Listed Since After', 'default': None, 'description': 'ISO-8601. When the company last put the role on the market â\x80\x94 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}}}
Esquema de salida
{'type': 'object', 'title': 'search_jobs_toolDictOutput', 'additionalProperties': True}
stats
Index statistics
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.
Esquema de entrada
{'type': 'object', 'title': 'stats_toolArguments', 'properties': {}}
Esquema de salida
{'type': 'object', 'title': 'stats_toolDictOutput', 'additionalProperties': True}
Añadido
stats
17 de September de 2026 a las 12:53
Añadido
hiring_signal
17 de September de 2026 a las 12:53
Añadido
company_jobs
17 de September de 2026 a las 12:53
Añadido
get_job
17 de September de 2026 a las 12:53
Añadido
job_changes
17 de September de 2026 a las 12:53
Añadido
search_jobs
17 de September de 2026 a las 12:53