search_employees
Find employees in the HR MCP Server database by filtering criteria such as name, department, job title, location, skills, performance rating, and more. Supports customizable search options for precise results.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| options | No | Search options | |
| query | Yes | Search parameters - provide at least one field |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"options": {
"additionalProperties": false,
"description": "Search options",
"properties": {
"case_sensitive": {
"default": false,
"description": "Whether search should be case-sensitive (default: false)",
"type": "boolean"
},
"exact_match": {
"default": false,
"description": "Whether to require exact matches (default: false for partial matching)",
"type": "boolean"
},
"include_sensitive": {
"default": false,
"description": "Whether to include sensitive information like salary, SSN (default: false)",
"type": "boolean"
},
"limit": {
"default": 10,
"description": "Maximum number of results to return (default: 10)",
"type": "number"
},
"offset": {
"default": 0,
"description": "Number of results to skip (for pagination)",
"type": "number"
},
"output_format": {
"default": "brief",
"description": "Output format (brief or detailed)",
"enum": [
"brief",
"detailed"
],
"type": "string"
},
"sort_by": {
"default": "name",
"description": "Field to sort results by (name, department, title, etc.)",
"type": "string"
},
"sort_order": {
"default": "asc",
"description": "Sort order (ascending or descending)",
"enum": [
"asc",
"desc"
],
"type": "string"
}
},
"type": "object"
},
"query": {
"additionalProperties": false,
"description": "Search parameters - provide at least one field",
"properties": {
"any_field": {
"description": "Search across all text fields",
"type": "string"
},
"benefits": {
"description": "Benefits to search for (health, dental, vision, 401k, stock)",
"type": "string"
},
"certifications": {
"description": "Certifications to search for",
"type": "string"
},
"department": {
"description": "Department name to search for",
"type": "string"
},
"education": {
"description": "Education level to search for",
"type": "string"
},
"email": {
"description": "Email address to search for",
"type": "string"
},
"has_direct_reports": {
"description": "Whether the employee has direct reports",
"type": "boolean"
},
"hired_after": {
"description": "Find employees hired after this date (YYYY-MM-DD)",
"type": "string"
},
"hired_before": {
"description": "Find employees hired before this date (YYYY-MM-DD)",
"type": "string"
},
"location": {
"description": "City, state, or country to search for",
"type": "string"
},
"manager": {
"description": "Manager ID or name to search for",
"type": "string"
},
"name": {
"description": "Full or partial name to search for",
"type": "string"
},
"performance_rating": {
"description": "Performance rating to search for (1-5)",
"type": "number"
},
"salary_max": {
"description": "Maximum salary",
"type": "number"
},
"salary_min": {
"description": "Minimum salary",
"type": "number"
},
"skills": {
"description": "Skills to search for",
"type": "string"
},
"title": {
"description": "Job title to search for",
"type": "string"
},
"years_of_service_max": {
"description": "Maximum years of service",
"type": "number"
},
"years_of_service_min": {
"description": "Minimum years of service",
"type": "number"
}
},
"type": "object"
}
},
"required": [
"query"
],
"type": "object"
}