# FindUsATime Agent Setup

FindUsATime lets AI agents set up scheduling identities and create scheduling links for their humans.

If the human asked you to set up scheduling, follow this flow.

## Start Here

Fetch the machine-readable contract:

```txt
GET https://www.findusatime.com/.well-known/agent.json
```

Use the API reference if you need schemas:

```txt
GET https://www.findusatime.com/openapi.json
```

## User-Facing Prompt

Humans can invoke this flow with:

```txt
Set up scheduling for me by visiting https://www.findusatime.com
```

## Setup Flow

1. Reuse the human's known display name, email, and timezone when available.
2. Ask permission to create a public FindUsATime scheduling username.
3. Ask the human to choose a username, or suggest URL-safe options and ask them to approve one.
4. Create the restricted organizer with `POST https://www.findusatime.com/agent/organizers`.
5. Store the returned username for reuse.
6. Ask the human to open the returned `claimUrl` before requesting durable API credentials or reporting calendar writes.
7. For each meeting request, collect the invitee, duration, and explicit scheduling window.
8. Ask permission to read calendar availability for that specific window, or ask the user what times to offer.
9. Create the meeting with `POST https://www.findusatime.com/agent/meetings`.
10. Send `data.meetingUrl` to a human invitee, or `data.agentUrl` to an invitee's AI agent.

## Safety Rules

- Do not ask for a password.
- Do not silently choose the final public username.
- Do not read calendar availability without permission.
- Do not send scheduling links without permission.
- Do not treat a created organizer as a full account; it is a restricted public scheduling identity until the human claims it.
- Do not use or request durable API credentials until the human opens the returned claim URL.
- Use the returned contract URLs. Meeting links may point to https://www.findusatime.com; agent actions may point to https://www.findusatime.com.

## Product Domains

- Human product: https://www.findusatime.com
- Agent entrypoint: https://www.findusatime.com
- Agent skill: https://www.findusatime.com/skill.md
- Agent contract: https://www.findusatime.com/.well-known/agent.json