Recruiter Roles - Job Board and Salary Reports
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RECRUITER_ROLES_API_KEY | Yes | Your free Recruiter Roles API key. Get one at https://recruiterroles.com/api-access | |
| RECRUITER_ROLES_BASE_URL | No | Base URL for the Recruiter Roles API (optional, for development) | https://recruiterroles.com |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_jobsA | 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. |
| get_jobA | Fetch the full detail for a single job by its slug, including the complete description, requirements, benefits, tech stack, and apply contact. |
| list_companiesA | Browse the directory of recruiting companies and agencies with their active job counts. Filter by name, company type, or HQ country. |
| get_companyA | Fetch a single company's full profile plus a paginated list of its active jobs. |
| list_sectorsA | List all recruiting sectors with their current active job counts. Use the returned slugs for the 'sector' filter in search_jobs. |
| list_locationsA | 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. |
| market_statsA | Aggregate market overview: total active jobs, posting velocity (24h / 7d), and breakdowns by sector, employment type, work arrangement, and country. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool has a clear, distinct purpose: get_company and get_job retrieve single entities, list_* tools browse catalogs, market_stats provides aggregate data, and search_jobs handles search. There is no functional overlap.
All tool names use lowercase with underscores, follow a consistent pattern (get_ for single items, list_ for browsing, search_ for search, and a descriptive noun for market stats). No mixed conventions.
Seven tools are well-scoped for a job board and salary reports domain, covering browsing, searching, and market statistics without being too few or excessive.
The tool set covers core CRUD-like operations (listing, reading, searching) and market aggregation. A dedicated salary report tool is missing, but salary data is accessible via search and market_stats, so gaps are minor.