Recruiter Roles Mcp

Working · 1.8 s

io.github.pcmarts/recruiter-roles-mcpv1.0.0

Search Recruiter Roles: live recruiter jobs, companies, sectors, locations, and market stats.

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://recruiterroles.com/api/mcp

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.

get_company Read-only

Fetch a single company's full profile plus a paginated list of its active jobs.

slugstring, required

The company slug (e.g. 'robert-half').

pageinteger

Page of the company's jobs. Default: 1.

per_pageinteger

Jobs per page. Default: 20, max: 100.

Tools (7)

get_company

Fetch a single company's full profile plus a paginated list of its active jobs.

read-only

Argument	Type	Description
page	integer	Page of the company's jobs. Default: 1.
slug*	string	The company slug (e.g. 'robert-half').
per_page	integer	Jobs per page. Default: 20, max: 100.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page of the company's jobs. Default: 1."
    },
    "slug": {
      "type": "string",
      "description": "The company slug (e.g. 'robert-half')."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Jobs per page. Default: 20, max: 100."
    }
  },
  "additionalProperties": false
}

get_job

Fetch the full detail for a single job by its slug, including the complete description, requirements, benefits, tech stack, and apply contact.

read-only

Argument	Type	Description
slug*	string	The job slug (the last path segment of its URL, or the 'slug' field from search_jobs).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "The job slug (the last path segment of its URL, or the 'slug' field from search_jobs)."
    }
  },
  "additionalProperties": false
}

list_companies

Browse the directory of recruiting companies and agencies with their active job counts. Filter by name, company type, or HQ country.

read-only

Argument	Type	Description
q	string	Search company name.
page	integer	Page number. Default: 1.
sort	string	Sort order. Default: job_count.
country	string	HQ country code (e.g. 'US', 'GB').
per_page	integer	Results per page. Default: 20, max: 100.
company_type	string	Company type filter.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search company name."
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number. Default: 1."
    },
    "sort": {
      "enum": [
        "job_count",
        "name",
        "recent"
      ],
      "type": "string",
      "description": "Sort order. Default: job_count."
    },
    "country": {
      "type": "string",
      "description": "HQ country code (e.g. 'US', 'GB')."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Results per page. Default: 20, max: 100."
    },
    "company_type": {
      "enum": [
        "staffing_agency",
        "executive_search",
        "boutique_firm",
        "corporate_inhouse",
        "rpo",
        "other"
      ],
      "type": "string",
      "description": "Company type filter."
    }
  },
  "additionalProperties": false
}

list_locations

List the location hierarchy (countries, regions, or cities) with active job counts. Use the returned codes/slugs for the 'state' and 'city' filters in search_jobs.

read-only

Argument	Type	Description
level	string	Hierarchy level to return. Default: countries.
region	string	Filter cities by region code (e.g. 'TX'). Use with level=cities.
country	string	Filter by country code (e.g. 'US', 'GB').

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "level": {
      "enum": [
        "countries",
        "regions",
        "cities"
      ],
      "type": "string",
      "description": "Hierarchy level to return. Default: countries."
    },
    "region": {
      "type": "string",
      "description": "Filter cities by region code (e.g. 'TX'). Use with level=cities."
    },
    "country": {
      "type": "string",
      "description": "Filter by country code (e.g. 'US', 'GB')."
    }
  },
  "additionalProperties": false
}

list_sectors

List all recruiting sectors with their current active job counts. Use the returned slugs for the 'sector' filter in search_jobs.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

market_stats

Aggregate market overview: total active jobs, posting velocity (24h / 7d), and breakdowns by sector, employment type, work arrangement, and country.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

search_jobs

Search live recruiter and talent-acquisition job listings on Recruiter Roles. Supports full-text search and filtering by sector, location, employment type, work arrangement, salary, and recency. Returns a paginated list with salary, company, location, and a tracked apply URL.

read-only

Argument	Type	Description
q	string	Full-text search across job title and company name.
city	string	City slug, comma-separated (e.g. 'dallas-tx').
page	integer	Page number. Default: 1.
sort	string	Sort order. Default: recent.
state	string	State/region code, comma-separated (e.g. 'TX,NY,BC'). Use list_locations for codes.
sector	string	Sector slug, comma-separated for multiple (e.g. 'technology,financial-services'). Use list_sectors for valid slugs.
per_page	integer	Results per page. Default: 20, max: 100.
is_remote	boolean	Shorthand for work_arrangement=remote.
salary_min

{ "type": "object", "$schema": "http://json-schema.org/draft-07/schema#", "properties": { "q": { "type": "string", "description": "Full-text search across job title and company name." }, "city": { "type": "string", "description": "City slug, comma-separated (e.g. 'dallas-tx')." }, "page": { "type": "integer", "minimum": 1, "description": "Page number. Default: 1." }, "sort": { "enum": [ "recent", "salary_desc" ], "type": "string", "description": "Sort order. Default: recent." }, "state": { "type": "string", "description": "State/region code, comma-separated (e.g. 'TX,NY,BC'). Use list_locations for codes." }, "sector": { "type": "string", "description": "Sector slug, comma-separated for multiple (e.g. 'technology,financial-services'). Use list_sectors for valid slugs." }, "per_page": { "type": "integer", "maximum": 100, "minimum": 1, "description": "Results per page. Default: 20, max: 100." }, "is_remote": { "type": "boolean", "description": "Shorthand for work_arrangement=remote." }, "salary_min": { "type": "integer", "description": "Minimum salary in USD. Only returns jobs with a disclosed salary at or above this." }, "source_type": { "enum": [ "direct", "scraped" ], "type": "string", "description": "'direct' = employer-posted, 'scraped' = aggregated." }, "posted_since": { "type": "string", "description": "ISO date — jobs posted on or after this date." }, "updated_since": { "type": "string", "description": "ISO datetime — for incremental sync; jobs updated on or after this." }, "employment_type": { "enum": [ "full_time", "part_time", "contract", "freelance" ], "type": "string", "description": "Employment type filter." }, "salary_disclosed": { "type": "boolean", "description": "true = only jobs with a disclosed salary; false = only undisclosed." }, "work_arrangement": { "enum": [ "on_site", "hybrid", "remote" ], "type": "string", "description": "Work arrangement filter." } }, "additionalProperties": false }