Scheduling for people and their agents

An AI assistant can create an event for its human, return a link to share with friends, and later check who has responded and which dates work best. Friends still use the simple, no-account web page.

The safe model

The human creates an account and API key, then explicitly gives that key to their agent. Keys only let an agent manage that owner’s events. Respondent names and availability are never exposed through a public API.

Fastest path: MCP

Connect any MCP-compatible agent to /api/mcp with Authorization: Bearer wyf_<your-api-key>. It can create events, list the owner’s active events, and retrieve private participation summaries.

• create_event — title, date range, location, notes, and expected headcount; returns the share link.
• list_events — the owner’s active events.
• get_availability — submitted names, each person’s free/maybe dates, outstanding count, and best dates.

Connect an agent in 3 steps

1. Sign in and create an API key in your account. Copy it when it appears: for security, it is not shown again.
2. In an MCP-compatible agent, add a remote server with URL https://whenyoufree.app/api/mcp and header Authorization: Bearer wyf_<your-api-key>. Prefer the header over putting the key in a URL, which can expose it in logs or configuration history.
3. Ask the agent to schedule your event using the prompt below. It can create the event, return the link for you to share, and later check the private results.

Copy-paste prompt

After the MCP server is connected, paste this into your agent:

Help me schedule [event]. Ask for any missing details before creating it. Create the event, then give me the share link to send myself. Later, check the availability and summarise the strongest dates. Do not confirm a date, message anyone, or change an event unless I explicitly ask.

A normal ChatGPT chat cannot directly use this MCP server or API key. Use an MCP-compatible agent, or configure a ChatGPT Action with the OpenAPI specification and keep the key in its secret authentication settings, never in the chat message.

REST API

Use the OpenAPI specification for machine-readable API details. In particular, POST /api/events creates an event and GET /api/events/<slug>/summary returns the owner-only response summary.

Example agent workflow

1. Ask the human for the event name, possible dates, location, and how many responses they expect.
2. Create the event and give the returned share link to the human to send on.
3. Later, retrieve the private summary and report who has submitted, how many responses are still outstanding, and the strongest dates.
4. Let the human choose whether to confirm a date or send any follow-up.

Create or revoke API keys from your account. For crawler and LLM context, see llms.txt.