Metadata-Version: 2.4
Name: gadgethumans-hr-mcp
Version: 1.0.0
Summary: MCP server for HR & Workforce Management — payroll, offer letters, time-off tracking, employee onboarding, benefits, performance evaluations, termination documents, and workforce reporting.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0

# GadgetHumans HR MCP Server

MCP server for HR & Workforce Management — payroll, offer letters, time-off tracking, employee onboarding, benefits, performance evaluations, termination documents, and workforce reporting.

## Tools

| Tool | Description |
|------|-------------|
| `calculate_payroll` | Calculate payroll for an employee for a given pay period |
| `generate_offer_letter` | Generate a job offer letter for a candidate |
| `track_time_off` | Track employee time-off requests, balances, and history |
| `onboard_employee` | Generate an employee onboarding plan and checklist |
| `calculate_benefits` | Calculate employee benefits costs and coverage details |
| `evaluate_performance` | Generate a performance evaluation template or summary |
| `generate_termination_document` | Generate an employee termination or separation document |
| `run_workforce_report` | Generate a workforce analytics report |

## Usage

```bash
# Run directly
uv run python server.py

# Or install and run
uv pip install -e .
gadgethumans-hr-mcp

# In Claude Desktop / any MCP client:
# {
#   "mcpServers": {
#     "hr": {
#       "command": "uv",
#       "args": ["run", "--directory", "/path/to/gadgethumans-hr-mcp", "python", "server.py"]
#     }
#   }
# }
```

## Development

```bash
# Create virtual environment
uv venv
source .venv/bin/activate

# Install in editable mode
uv pip install -e .

# Run the server
python server.py
```

## Status

Placeholder implementation. Tools return structured placeholder responses. Connect to real HRIS/payroll engines (Workday, BambooHR, Gusto, Rippling, etc.) for production use.
