Metadata-Version: 2.4
Name: mcp-timer
Version: 0.2.2
Summary: MCP Timer Server - Wait and scheduled timing tools for AI agents
Project-URL: Homepage, https://github.com/aleck31/mcp-timer
Project-URL: Repository, https://github.com/aleck31/mcp-timer
Project-URL: Issues, https://github.com/aleck31/mcp-timer/issues
Author: aleck31
License-Expression: MIT
Keywords: agent,ai,cron,mcp,scheduling,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

| Tool | Description |
|------|-------------|
| `wait(seconds)` | Wait for specified seconds |
| `wait_until(target_time, next_day_if_passed)` | Wait until specified time (HH:MM:SS or YYYY-MM-DD HH:MM:SS) |
| `cron_wait(expression, timeout_seconds)` | Wait until next cron expression match |
| `countdown(seconds, interval)` | Countdown with periodic progress reports |
| `timeout_guard(seconds, message)` | Wait then return timeout signal |
| `timestamp(fmt, offset_seconds)` | Get current time in various formats |

### 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
```

### timestamp formats

- `iso` (default) - ISO 8601 format
- `unix` - Unix timestamp
- `date` - YYYY-MM-DD
- `time` - HH:MM:SS
- Custom strftime pattern (e.g. `%Y/%m/%d %H:%M`)

## MCP Configuration

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

## Release

Publishing is automated via GitHub Actions. To release:

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

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
