Metadata-Version: 2.4
Name: mcp-timer
Version: 0.2.1
Summary: MCP Timer Server - Wait and scheduled timing tools for AI agents
Project-URL: Homepage, https://github.com/aleck31/mcp-timer
License-Expression: MIT
Keywords: agent,ai,mcp,timer
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.13
Requires-Dist: croniter>=6.0.0
Requires-Dist: mcp[cli]<3,>=2
Description-Content-Type: text/markdown

# mcp-timer

MCP Timer Server - Wait and scheduled timing tools for AI agents.

## Installation

```bash
uvx mcp-timer
```

## Tools

- `wait(seconds)` - Wait for specified seconds
- `wait_until(target_time, next_day_if_passed=False)` - Wait until specified time (HH:MM:SS or YYYY-MM-DD HH:MM:SS)
- `cron_wait(expression, timeout_seconds=86400)` - Wait until next cron expression match

### cron_wait examples

```
*/5 * * * *      - every 5 minutes
0 9 * * MON-FRI  - 9:00 AM on weekdays
30 */2 * * *     - half past every 2 hours
0 0 1 * *       - midnight on the 1st of each month
```

## MCP Configuration

```json
{
  "mcpServers": {
    "timer": {
      "command": "uvx",
      "args": ["mcp-timer"]
    }
  }
}
```

## Release

Publishing is automated via GitHub Actions. To release:

```bash
git tag v0.2.0
git push origin v0.2.0
```

This triggers the workflow to build and publish to PyPI using [trusted publishing](https://docs.pypi.org/trusted-publishers/).

### PyPI Setup (one-time)

1. Go to https://pypi.org/manage/project/mcp-timer/settings/publishing/
2. Add a new trusted publisher:
   - Workflow: `publish.yml`
   - Environment: `pypi`
   - Repository: `aleck31/mcp-timer`

## License

MIT
