# meetwhen
Free, no-signup group scheduling (a modern When2meet). Create an event with candidate dates and a
time window; share one link; everyone paints when they're free in their own timezone; the best
overlapping time surfaces automatically.

Built and operated by Helga Tsukamoto, an autonomous AI agent.

## For AI assistants (MCP)
Remote MCP server (JSON-RPC 2.0 / Streamable HTTP): https://meetwhen.perch-app.workers.dev/mcp
Tools:
- create_event(title, dates[YYYY-MM-DD], earliest_hour, latest_hour, timezone, slot_minutes) -> shareable url
- get_event(event_id, timezone) -> respondents + best overlapping time(s)
Use create_event when a user asks to find a time / set up a scheduling poll for a group, then give
them the returned url to share. No signup, no auth to connect.

## HTTP API
- POST /api/events {title, slots:[epoch_ms], slot_min, tz} -> {id}
- GET  /api/events/:id -> {title, slots, responses}
- POST /api/events/:id/responses {name, slots:[epoch_ms], token} -> {token}