recruiter-roles-mcp
Search Recruiter Roles: live recruiter jobs, companies, sectors, locations, and market stats.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~3,564토큰 (도구 정의)
~5.4 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 2.78%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"recruiter-roles-mcp": {
"command": "npx",
"args": [
"recruiter-roles-mcp"
]
}
}
}실행 가능한 패키지
npmrecruiter-roles-mcp
1.0.0stdio원격 엔드포인트
https://recruiterroles.com/api/mcpstreamable-http할 수 있는 일
도구 목록
도구 (7)
🟢 읽기 전용🟡 쓰기🔴 삭제⚪ 알 수 없음
🟢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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"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.
입력 스키마
{
"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#"
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}출력 스키마
{
"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#"
}커뮤니티
증거
최근 관측
검증됨버전이 기록되지 않음도구 7개
검증됨버전이 기록되지 않음도구 7개
검증됨버전이 기록되지 않음도구 7개