io.github.CSOAI-ORG/recruitment-ai-mcp

Generate a professional job description. Args: title: Job title (e.g. "Software Engineer", "Product Manager") department: Department (e.g. "Engineering", "Marketing") level: Seniority level: junior, mid, senior, lead skills: Required skills list company_name: Company name remote: Whether the role is remote key_responsibilities: Custom responsibilities (auto-generated if omitted) Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.

Score and analyze a CV/resume against job requirements. Args: cv_text: Full text of the CV/resume required_skills: Must-have skills preferred_skills: Nice-to-have skills min_years_experience: Minimum years of experience required required_education: Required education level (e.g. "bachelor", "master") Behavior: This tool is read-only and stateless — it produces analysis output without modifying any external systems, databases, or files. Safe to call repeatedly with identical inputs (idempotent). Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.

Generate tailored interview questions for a role. Args: role: Job role (e.g. "Software Engineer") level: Seniority: junior, mid, senior, lead categories: Question types: behavioral, technical, leadership, culture_fit count: Total number of questions (max 20) skills_to_probe: Specific skills to ask about Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results.

Get salary benchmarks for a role by level and location. Args: role: Role category (software_engineer, data_scientist, product_manager, designer, marketing, sales, devops, qa_engineer, project_manager, hr) level: Seniority: junior, mid, senior, lead location: Location key (london, new_york, san_francisco, berlin, remote, us, uk, eu, etc.) currency: Output currency code Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent — calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.

Draft a professional offer letter for a candidate. Args: candidate_name: Full name of the candidate role: Job title offered salary: Annual base salary currency: Currency code start_date: Proposed start date (YYYY-MM-DD) company_name: Company name benefits: List of benefits to include probation_months: Probation period in months notice_period_weeks: Notice period in weeks annual_leave_days: Annual leave entitlement reporting_to: Manager's name/title Behavior: This tool generates structured output without modifying external systems. Output is deterministic for identical inputs. No side effects. Free tier: 10/day rate limit. Pro tier: unlimited. No authentication required for basic usage. When to use: Use this tool when you need structured analysis or classification of inputs against established frameworks or standards. When NOT to use: Not suitable for real-time production decision-making without human review of results. Behavioral Transparency: - Side Effects: This tool is read-only and produces no side effects. It does not modify any external state, databases, or files. All output is computed in-memory and returned directly to the caller. - Authentication: No authentication required for basic usage. Pro/Enterprise tiers require a valid MEOK API key passed via the MEOK_API_KEY environment variable. - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are included in responses (X-RateLimit-Remaining, X-RateLimit-Reset). - Error Handling: Returns structured error objects with 'error' key on failure. Never raises unhandled exceptions. Invalid inputs return descriptive validation errors. - Idempotency: Fully idempotent — calling with the same inputs always produces the same output. Safe to retry on timeout or transient failure. - Data Privacy: No input data is stored, logged, or transmitted to external services. All processing happens locally within the MCP server process.