Server definition
- Hash
- sha256:77264c261d4085a41a9b8e508882843d27df8d9200b50f1865a603221e86fed8
- What it is
- What a remote MCP server returned when asked what it offers: 7 tools
The blob, as servednamed by its sha256
{
"instructions": "Recruiter Roles serves live recruiter and talent-acquisition job listings (read-only). These tools need a free API key: create one at https://recruiterroles.com/api-access, then connect with ?key=rr_live_... in the URL or an Authorization: Bearer rr_live_... header. Start with search_jobs — filter by sector, location, salary, remote, recency, or full-text q — then call get_job with a slug for the full description and apply details. The sector and location filters need exact slugs/codes: fetch them from list_sectors and list_locations first. Use list_companies/get_company for agencies and market_stats for aggregate trends. All tools share one API key and a 1,000 requests/day limit, so prefer narrow filters and reasonable per_page values over broad scans. A job's `url` field is a tracked link — prefer it when linking out.",
"tools": [
{
"description": "Fetch a single company's full profile plus a paginated list of its active jobs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"page": {
"description": "Page of the company's jobs. Default: 1.",
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Jobs per page. Default: 20, max: 100.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"slug": {
"description": "The company slug (e.g. 'robert-half').",
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_company",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"active_job_count": {
"type": "number"
},
"company_type": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"employee_count_range": {
"type": [
"string",
"null"
]
},
"founded_year": {
"type": [
"number",
"null"
]
},
"headquarters": {
"additionalProperties": false,
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"is_verified": {
"type": "boolean"
},
"jobs": {
"additionalProperties": false,
"properties": {
"data": {
"items": {
"additionalProperties": false,
"properties": {
"apply_url": {
"type": [
"string",
"null"
]
},
"billing_target": {
"$ref": "#/properties/data/properties/jobs/properties/data/items/properties/commission"
},
"canonical_url": {
"type": "string"
},
"commission": {
"additionalProperties": false,
"properties": {
"details": {
"type": [
"string",
"null"
]
},
"disclosed": {
"type": "boolean"
}
},
"type": "object"
},
"company_logo_url": {
"type": [
"string",
"null"
]
},
"company_name": {
"type": [
"string",
"null"
]
},
"company_website": {
"type": [
"string",
"null"
]
},
"description_excerpt": {
"type": "string"
},
"employment_type": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"is_featured": {
"type": "boolean"
},
"is_homepage_featured": {
"type": "boolean"
},
"location": {
"additionalProperties": false,
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"is_remote": {
"type": "boolean"
},
"state": {
"type": [
"string",
"null"
]
},
"work_arrangement": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"posted_at": {
"type": [
"string",
"null"
]
},
"primary_sector": {
"type": [
"string",
"null"
]
},
"salary": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"disclosed": {
"type": "boolean"
},
"max_dollars": {
"type": [
"number",
"null"
]
},
"min_dollars": {
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"secondary_sectors": {
"items": {
"type": "string"
},
"type": "array"
},
"slug": {
"type": "string"
},
"source_type": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"meta": {
"additionalProperties": false,
"properties": {
"next_page": {
"type": [
"number",
"null"
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"prev_page": {
"type": [
"number",
"null"
]
},
"total": {
"type": "number"
},
"total_pages": {
"type": "number"
}
},
"type": "object"
}
},
"required": [
"data",
"meta"
],
"type": "object"
},
"linkedin_url": {
"type": [
"string",
"null"
]
},
"logo_url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"specialties": {
"items": {
"type": "string"
},
"type": "array"
},
"url": {
"type": "string"
},
"website_url": {
"type": [
"string",
"null"
]
}
},
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "Fetch the full detail for a single job by its slug, including the complete description, requirements, benefits, tech stack, and apply contact.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"slug": {
"description": "The job slug (the last path segment of its URL, or the 'slug' field from search_jobs).",
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "get_job",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"apply_email": {
"type": [
"string",
"null"
]
},
"apply_url": {
"type": [
"string",
"null"
]
},
"benefits": {
"type": [
"string",
"null"
]
},
"billing_target": {
"$ref": "#/properties/data/properties/commission"
},
"canonical_url": {
"type": "string"
},
"commission": {
"additionalProperties": false,
"properties": {
"details": {
"type": [
"string",
"null"
]
},
"disclosed": {
"type": "boolean"
}
},
"type": "object"
},
"company_logo_url": {
"type": [
"string",
"null"
]
},
"company_name": {
"type": [
"string",
"null"
]
},
"company_website": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"employment_type": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"is_featured": {
"type": "boolean"
},
"is_homepage_featured": {
"type": "boolean"
},
"is_sticky": {
"type": "boolean"
},
"location": {
"additionalProperties": false,
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"is_remote": {
"type": "boolean"
},
"state": {
"type": [
"string",
"null"
]
},
"work_arrangement": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"posted_at": {
"type": [
"string",
"null"
]
},
"primary_sector": {
"type": [
"string",
"null"
]
},
"requirements": {
"type": [
"string",
"null"
]
},
"salary": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"disclosed": {
"type": "boolean"
},
"max_dollars": {
"type": [
"number",
"null"
]
},
"min_dollars": {
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"secondary_sectors": {
"items": {
"type": "string"
},
"type": "array"
},
"slug": {
"type": "string"
},
"source_type": {
"type": [
"string",
"null"
]
},
"team_size": {
"anyOf": [
{
"type": [
"string",
"number"
]
},
{
"type": "null"
}
]
},
"tech_stack": {
"items": {
"type": "string"
},
"type": "array"
},
"title": {
"type": "string"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"type": "object"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "Browse the directory of recruiting companies and agencies with their active job counts. Filter by name, company type, or HQ country.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"company_type": {
"description": "Company type filter.",
"enum": [
"staffing_agency",
"executive_search",
"boutique_firm",
"corporate_inhouse",
"rpo",
"other"
],
"type": "string"
},
"country": {
"description": "HQ country code (e.g. 'US', 'GB').",
"type": "string"
},
"page": {
"description": "Page number. Default: 1.",
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Results per page. Default: 20, max: 100.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"q": {
"description": "Search company name.",
"type": "string"
},
"sort": {
"description": "Sort order. Default: job_count.",
"enum": [
"job_count",
"name",
"recent"
],
"type": "string"
}
},
"type": "object"
},
"name": "list_companies",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"items": {
"additionalProperties": false,
"properties": {
"active_job_count": {
"type": "number"
},
"company_type": {
"type": [
"string",
"null"
]
},
"description": {
"type": [
"string",
"null"
]
},
"employee_count_range": {
"type": [
"string",
"null"
]
},
"founded_year": {
"type": [
"number",
"null"
]
},
"headquarters": {
"additionalProperties": false,
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"country": {
"type": [
"string",
"null"
]
},
"state": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"is_verified": {
"type": "boolean"
},
"linkedin_url": {
"type": [
"string",
"null"
]
},
"logo_url": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"specialties": {
"items": {
"type": "string"
},
"type": "array"
},
"website_url": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"meta": {
"additionalProperties": false,
"properties": {
"next_page": {
"type": [
"number",
"null"
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"prev_page": {
"type": [
"number",
"null"
]
},
"total": {
"type": "number"
},
"total_pages": {
"type": "number"
}
},
"type": "object"
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data",
"meta"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"country": {
"description": "Filter by country code (e.g. 'US', 'GB').",
"type": "string"
},
"level": {
"description": "Hierarchy level to return. Default: countries.",
"enum": [
"countries",
"regions",
"cities"
],
"type": "string"
},
"region": {
"description": "Filter cities by region code (e.g. 'TX'). Use with level=cities.",
"type": "string"
}
},
"type": "object"
},
"name": "list_locations",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"items": {
"additionalProperties": true,
"properties": {},
"type": "object"
},
"type": "array"
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "List all recruiting sectors with their current active job counts. Use the returned slugs for the 'sector' filter in search_jobs.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "list_sectors",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"items": {
"additionalProperties": false,
"properties": {
"job_count": {
"type": "number"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "Aggregate market overview: total active jobs, posting velocity (24h / 7d), and breakdowns by sector, employment type, work arrangement, and country.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {},
"type": "object"
},
"name": "market_stats",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"additionalProperties": false,
"properties": {
"by_employment_type": {
"additionalProperties": {
"type": "number"
},
"type": "object"
},
"by_sector": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"by_work_arrangement": {
"additionalProperties": {
"type": "number"
},
"type": "object"
},
"jobs_posted_24h": {
"type": "number"
},
"jobs_posted_7d": {
"type": "number"
},
"top_countries": {
"items": {
"additionalProperties": false,
"properties": {
"count": {
"type": "number"
},
"name": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"total_active_jobs": {
"type": "number"
}
},
"type": "object"
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data"
],
"type": "object"
}
},
{
"description": "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.",
"inputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"city": {
"description": "City slug, comma-separated (e.g. 'dallas-tx').",
"type": "string"
},
"employment_type": {
"description": "Employment type filter.",
"enum": [
"full_time",
"part_time",
"contract",
"freelance"
],
"type": "string"
},
"is_remote": {
"description": "Shorthand for work_arrangement=remote.",
"type": "boolean"
},
"page": {
"description": "Page number. Default: 1.",
"minimum": 1,
"type": "integer"
},
"per_page": {
"description": "Results per page. Default: 20, max: 100.",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"posted_since": {
"description": "ISO date — jobs posted on or after this date.",
"type": "string"
},
"q": {
"description": "Full-text search across job title and company name.",
"type": "string"
},
"salary_disclosed": {
"description": "true = only jobs with a disclosed salary; false = only undisclosed.",
"type": "boolean"
},
"salary_min": {
"description": "Minimum salary in USD. Only returns jobs with a disclosed salary at or above this.",
"type": "integer"
},
"sector": {
"description": "Sector slug, comma-separated for multiple (e.g. 'technology,financial-services'). Use list_sectors for valid slugs.",
"type": "string"
},
"sort": {
"description": "Sort order. Default: recent.",
"enum": [
"recent",
"salary_desc"
],
"type": "string"
},
"source_type": {
"description": "'direct' = employer-posted, 'scraped' = aggregated.",
"enum": [
"direct",
"scraped"
],
"type": "string"
},
"state": {
"description": "State/region code, comma-separated (e.g. 'TX,NY,BC'). Use list_locations for codes.",
"type": "string"
},
"updated_since": {
"description": "ISO datetime — for incremental sync; jobs updated on or after this.",
"type": "string"
},
"work_arrangement": {
"description": "Work arrangement filter.",
"enum": [
"on_site",
"hybrid",
"remote"
],
"type": "string"
}
},
"type": "object"
},
"name": "search_jobs",
"outputSchema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"data": {
"items": {
"additionalProperties": false,
"properties": {
"apply_url": {
"type": [
"string",
"null"
]
},
"billing_target": {
"$ref": "#/properties/data/items/properties/commission"
},
"canonical_url": {
"type": "string"
},
"commission": {
"additionalProperties": false,
"properties": {
"details": {
"type": [
"string",
"null"
]
},
"disclosed": {
"type": "boolean"
}
},
"type": "object"
},
"company_logo_url": {
"type": [
"string",
"null"
]
},
"company_name": {
"type": [
"string",
"null"
]
},
"company_website": {
"type": [
"string",
"null"
]
},
"description_excerpt": {
"type": "string"
},
"employment_type": {
"type": [
"string",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
},
"id": {
"type": "string"
},
"is_featured": {
"type": "boolean"
},
"is_homepage_featured": {
"type": "boolean"
},
"location": {
"additionalProperties": false,
"properties": {
"city": {
"type": [
"string",
"null"
]
},
"is_remote": {
"type": "boolean"
},
"state": {
"type": [
"string",
"null"
]
},
"work_arrangement": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"posted_at": {
"type": [
"string",
"null"
]
},
"primary_sector": {
"type": [
"string",
"null"
]
},
"salary": {
"additionalProperties": false,
"properties": {
"currency": {
"type": "string"
},
"disclosed": {
"type": "boolean"
},
"max_dollars": {
"type": [
"number",
"null"
]
},
"min_dollars": {
"type": [
"number",
"null"
]
}
},
"type": "object"
},
"secondary_sectors": {
"items": {
"type": "string"
},
"type": "array"
},
"slug": {
"type": "string"
},
"source_type": {
"type": [
"string",
"null"
]
},
"title": {
"type": "string"
},
"updated_at": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"meta": {
"additionalProperties": false,
"properties": {
"next_page": {
"type": [
"number",
"null"
]
},
"page": {
"type": "number"
},
"per_page": {
"type": "number"
},
"prev_page": {
"type": [
"number",
"null"
]
},
"total": {
"type": "number"
},
"total_pages": {
"type": "number"
}
},
"type": "object"
},
"response_generated_at": {
"type": "string"
}
},
"required": [
"data",
"meta"
],
"type": "object"
}
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:77264c261d4085a41a9b8e508882843d27df8d9200b50f1865a603221e86fed8 | sha256sum