Metadata-Version: 2.4
Name: usb-workday-agent
Version: 1.1.6
Summary: USB Workday Agent - MCP integration for Workday automation
Author: Amanda Winkles
Author-email: Amanda Winkles <amanda@example.com>
License: MIT
Project-URL: Homepage, https://github.com/amandawinkles/usb-workday-agent
Project-URL: Repository, https://github.com/amandawinkles/usb-workday-agent
Keywords: mcp,fastmcp,workday,automation,usb
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=0.9.0
Requires-Dist: fastmcp>=3.0.0
Requires-Dist: requests>=2.31.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: ruff>=0.1.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Requires-Dist: build>=1.0.0; extra == "dev"
Dynamic: author
Dynamic: license-file
Dynamic: requires-python

# USB Workday Agent

MCP integration for Workday automation.

## Overview

This project provides an MCP (Model Context Protocol) server for automating Workday operations. It leverages the FastMCP framework to expose tools and resources for Workday integration.

## Prerequisites

- Python 3.10 or higher
- a virtual environment
- MCP-compatible client (e.g., Claude Desktop, Bob)

## Installation

Create a new virtual environment:

```bash
# Create virtual environment
python -m venv venv

# Activate virtual environment
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -e .
```

## Development

### Install Development Dependencies

```bash
pip install -e ".[dev]"
```

### Code Formatting

```bash
# Format code with black
black .

# Lint with ruff
ruff check .
```

### Testing

```bash
pytest
```

## Project Structure

```
usb-workday-agent/
├── README.md
├── pyproject.toml
├── setup.py
└── (source files to be added)
```

## Dependencies

- **mcp** (>=0.9.0): Model Context Protocol core library
- **fastmcp** (>=3.0.0): FastMCP framework for building MCP servers

## Running the MCP Server

### Start the Server

```bash
# Activate the wxO-nit virtual environment
source ../wxO-nit/bin/activate

# Run the server directly
python3 server.py

# Or use the installed command (after pip install -e .)
usb-workday-agent
```

### MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop):

```json
{
  "mcpServers": {
    "usb-workday-agent": {
      "command": "python3",
      "args": [".../usb-workday-agent/server.py"],
      "env": {
        "PYTHONPATH": ".../lib/python3.10/site-packages"
      }
    }
  }
}
```

## Available Tools

The server provides the following tools for watsonx Orchestrate:

- **get_employee_daily_hours**: Get an employee's office wifi and VPN hours for a specific date
- **get_employee_session_details**: Get detailed session information for an employee
- **get_employee_weekly_summary**: Get an employee's weekly attendance summary
- **get_team_attendance_stats**: Get attendance statistics for a manager's team
- **query_individual_time**: Query data from individual employee office time logs

## Available Resources

- **workday://config**: Get Workday configuration details
- **workday://status**: Check connection status to Workday

## Configuration

Workday API credentials and configuration should be set via environment variables:

```bash
export WORKDAY_TENANT="your-tenant"
export WORKDAY_USERNAME="your-username"
export WORKDAY_PASSWORD="your-password"
export WORKDAY_API_VERSION="v1"
```

## License

MIT License

## Author

Amanda Winkles
