recruiter-roles-mcp
Search Recruiter Roles: live recruiter jobs, companies, sectors, locations, and market stats.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~3,564Tokens (definiciones de herramientas)
~5.4 KBTamaño de respuesta típico
Impacto significativo en la atención (2.78% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"recruiter-roles-mcp": {
"command": "npx",
"args": [
"recruiter-roles-mcp"
]
}
}
}Paquetes ejecutables
npmrecruiter-roles-mcp
1.0.0stdioPuntos de conexión remotos
https://recruiterroles.com/api/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (7)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢search_jobs(q, sector, state, city, employment_type, ...)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Full-text search across job title and company name."
},
"sector": {
"type": "string",
"description": "Sector slug, comma-separated for multiple (e.g. 'technology,financial-services'). Use list_sectors for valid slugs."
},
"state": {
"type": "string",
"description": "State/region code, comma-separated (e.g. 'TX,NY,BC'). Use list_locations for codes."
},
"city": {
"type": "string",
"description": "City slug, comma-separated (e.g. 'dallas-tx')."
},
"employment_type": {
"type": "string",
"enum": [
"full_time",
"part_time",
"contract",
"freelance"
],
"description": "Employment type filter."
},
"work_arrangement": {
"type": "string",
"enum": [
"on_site",
"hybrid",
"remote"
],
"description": "Work arrangement filter."
},
"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."
},
"salary_disclosed": {
"type": "boolean",
"description": "true = only jobs with a disclosed salary; false = only undisclosed."
},
"source_type": {
"type": "string",
"enum": [
"direct",
"scraped"
],
"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."
},
"sort": {
"type": "string",
"enum": [
"recent",
"salary_desc"
],
"description": "Sort order. Default: recent."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number. Default: 1."
},
"per_page": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Results per page. Default: 20, max: 100."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"company_name": {
"type": [
"string",
"null"
]
},
"company_website": {
"type": [
"string",
"null"
]
},
"company_logo_url": {
"type": [
"string",
"null"
]
},
"location": {
"type": "object",
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"is_remote": {
"type": "boolean"
},
"work_arrangement": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"employment_type": {
"type": [
"string",
"null"
]
},
"primary_sector": {
"type": [
"string",
"null"
]
},
"secondary_sectors": {
"type": "array",
"items": {
"type": "string"
}
},
"salary": {
"type": "object",
"properties": {
"disclosed": {
"type": "boolean"
},
"min_dollars": {
"type": [
"number",
"null"
]
},
"max_dollars": {
"type": [
"number",
"null"
]
},
"currency": {
"type": "string"
}
},
"additionalProperties": false
},
"commission": {
"type": "object",
"properties": {
"disclosed": {
"type": "boolean"
},
"details": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"billing_target": {
"$ref": "#/properties/data/items/properties/commission"
},
"source_type": {
"type": [
"string",
"null"
]
},
"apply_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
},
"canonical_url": {
"type": "string"
},
"posted_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"is_featured": {
"type": "boolean"
},
"is_homepage_featured": {
"type": "boolean"
},
"description_excerpt": {
"type": "string"
}
},
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total_pages": {
"type": "number"
},
"next_page": {
"type": [
"number",
"null"
]
},
"prev_page": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_job(slug)
Fetch the full detail for a single job by its slug, including the complete description, requirements, benefits, tech stack, and apply contact.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The job slug (the last path segment of its URL, or the 'slug' field from search_jobs)."
}
},
"required": [
"slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"company_name": {
"type": [
"string",
"null"
]
},
"company_website": {
"type": [
"string",
"null"
]
},
"company_logo_url": {
"type": [
"string",
"null"
]
},
"location": {
"type": "object",
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"is_remote": {
"type": "boolean"
},
"work_arrangement": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"employment_type": {
"type": [
"string",
"null"
]
},
"primary_sector": {
"type": [
"string",
"null"
]
},
"secondary_sectors": {
"type": "array",
"items": {
"type": "string"
}
},
"salary": {
"type": "object",
"properties": {
"disclosed": {
"type": "boolean"
},
"min_dollars": {
"type": [
"number",
"null"
]
},
"max_dollars": {
"type": [
"number",
"null"
]
},
"currency": {
"type": "string"
}
},
"additionalProperties": false
},
"commission": {
"type": "object",
"properties": {
"disclosed": {
"type": "boolean"
},
"details": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"billing_target": {
"$ref": "#/properties/data/properties/commission"
},
"source_type": {
"type": [
"string",
"null"
]
},
"apply_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
},
"canonical_url": {
"type": "string"
},
"posted_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"is_featured": {
"type": "boolean"
},
"is_homepage_featured": {
"type": "boolean"
},
"description": {
"type": [
"string",
"null"
]
},
"requirements": {
"type": [
"string",
"null"
]
},
"benefits": {
"type": [
"string",
"null"
]
},
"tech_stack": {
"type": "array",
"items": {
"type": "string"
}
},
"team_size": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"apply_email": {
"type": [
"string",
"null"
]
},
"is_sticky": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"required": [
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_companies(q, company_type, country, sort, page, ...)
Browse the directory of recruiting companies and agencies with their active job counts. Filter by name, company type, or HQ country.
Esquema de entrada
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search company name."
},
"company_type": {
"type": "string",
"enum": [
"staffing_agency",
"executive_search",
"boutique_firm",
"corporate_inhouse",
"rpo",
"other"
],
"description": "Company type filter."
},
"country": {
"type": "string",
"description": "HQ country code (e.g. 'US', 'GB')."
},
"sort": {
"type": "string",
"enum": [
"job_count",
"name",
"recent"
],
"description": "Sort order. Default: job_count."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number. Default: 1."
},
"per_page": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Results per page. Default: 20, max: 100."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"logo_url": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"website_url": {
"type": [
"string",
"null"
]
},
"linkedin_url": {
"type": [
"string",
"null"
]
},
"company_type": {
"type": [
"string",
"null"
]
},
"employee_count_range": {
"type": [
"string",
"null"
]
},
"headquarters": {
"type": "object",
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"specialties": {
"type": "array",
"items": {
"type": "string"
}
},
"founded_year": {
"type": [
"number",
"null"
]
},
"is_verified": {
"type": "boolean"
},
"active_job_count": {
"type": "number"
}
},
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total_pages": {
"type": "number"
},
"next_page": {
"type": [
"number",
"null"
]
},
"prev_page": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_company(slug, page, per_page)
Fetch a single company's full profile plus a paginated list of its active jobs.
Esquema de entrada
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "The company slug (e.g. 'robert-half')."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "Page of the company's jobs. Default: 1."
},
"per_page": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Jobs per page. Default: 20, max: 100."
}
},
"required": [
"slug"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"logo_url": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"website_url": {
"type": [
"string",
"null"
]
},
"linkedin_url": {
"type": [
"string",
"null"
]
},
"company_type": {
"type": [
"string",
"null"
]
},
"employee_count_range": {
"type": [
"string",
"null"
]
},
"headquarters": {
"type": "object",
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"specialties": {
"type": "array",
"items": {
"type": "string"
}
},
"founded_year": {
"type": [
"number",
"null"
]
},
"is_verified": {
"type": "boolean"
},
"active_job_count": {
"type": "number"
},
"url": {
"type": "string"
},
"jobs": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"company_name": {
"type": [
"string",
"null"
]
},
"company_website": {
"type": [
"string",
"null"
]
},
"company_logo_url": {
"type": [
"string",
"null"
]
},
"location": {
"type": "object",
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
},
"is_remote": {
"type": "boolean"
},
"work_arrangement": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"employment_type": {
"type": [
"string",
"null"
]
},
"primary_sector": {
"type": [
"string",
"null"
]
},
"secondary_sectors": {
"type": "array",
"items": {
"type": "string"
}
},
"salary": {
"type": "object",
"properties": {
"disclosed": {
"type": "boolean"
},
"min_dollars": {
"type": [
"number",
"null"
]
},
"max_dollars": {
"type": [
"number",
"null"
]
},
"currency": {
"type": "string"
}
},
"additionalProperties": false
},
"commission": {
"type": "object",
"properties": {
"disclosed": {
"type": "boolean"
},
"details": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"billing_target": {
"$ref": "#/properties/data/properties/jobs/properties/data/items/properties/commission"
},
"source_type": {
"type": [
"string",
"null"
]
},
"apply_url": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
},
"canonical_url": {
"type": "string"
},
"posted_at": {
"type": [
"string",
"null"
]
},
"updated_at": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"is_featured": {
"type": "boolean"
},
"is_homepage_featured": {
"type": "boolean"
},
"description_excerpt": {
"type": "string"
}
},
"additionalProperties": false
}
},
"meta": {
"type": "object",
"properties": {
"total": {
"type": "number"
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"total_pages": {
"type": "number"
},
"next_page": {
"type": [
"number",
"null"
]
},
"prev_page": {
"type": [
"number",
"null"
]
}
},
"additionalProperties": false
}
},
"required": [
"data",
"meta"
],
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"required": [
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_sectors
List all recruiting sectors with their current active job counts. Use the returned slugs for the 'sector' filter in search_jobs.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"job_count": {
"type": "number"
}
},
"additionalProperties": false
}
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢list_locations(level, country, region)
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.
Esquema de entrada
{
"type": "object",
"properties": {
"level": {
"type": "string",
"enum": [
"countries",
"regions",
"cities"
],
"description": "Hierarchy level to return. Default: countries."
},
"country": {
"type": "string",
"description": "Filter by country code (e.g. 'US', 'GB')."
},
"region": {
"type": "string",
"description": "Filter cities by region code (e.g. 'TX'). Use with level=cities."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
}
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢market_stats
Aggregate market overview: total active jobs, posting velocity (24h / 7d), and breakdowns by sector, employment type, work arrangement, and country.
Esquema de entrada
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}Esquema de salida
{
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"total_active_jobs": {
"type": "number"
},
"jobs_posted_24h": {
"type": "number"
},
"jobs_posted_7d": {
"type": "number"
},
"by_sector": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"name": {
"type": "string"
},
"count": {
"type": "number"
}
},
"additionalProperties": false
}
},
"by_employment_type": {
"type": "object",
"additionalProperties": {
"type": "number"
}
},
"by_work_arrangement": {
"type": "object",
"additionalProperties": {
"type": "number"
}
},
"top_countries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"count": {
"type": "number"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada7 herramientas
verificadoversión no registrada7 herramientas
verificadoversión no registrada7 herramientas