# Vennio Scheduling

Programmable time infrastructure — scheduling and availability tools for AI agents. 12 tools for availability, bookings, proposals, consent, and network queries.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add vennio/scheduling

# Browse available tools
npx -y @smithery/cli@latest tool list vennio/scheduling

# Get full schema for a tool
npx -y @smithery/cli@latest tool get vennio/scheduling find_availability

# Call a tool
npx -y @smithery/cli@latest tool call vennio/scheduling find_availability '{}'
```

## Direct MCP Connection

Endpoint: `https://scheduling--vennio.run.tools`

**Required config:**
- `apiKey` (header) — Your Vennio secret API key (vennio_sk_live_...)

## Tools (12)

- `find_availability` — Find bookable time slots for a business. Returns available slots within a date range, accounting for calendar events an…
- `find_mutual_availability` — Find time slots where ALL specified people are free. Requires consent from each principal. This is the signature Vennio…
- `create_booking` — Book a time slot on a business calendar. Creates a confirmed booking, sends confirmation emails, and fires webhooks. Th…
- `get_booking` — Retrieve details of a specific booking by ID.
- `cancel_booking` — Cancel an existing confirmed booking. Fires cancellation webhooks and notifies waitlisted customers if applicable.
- `propose_meeting` — Create a multi-party meeting proposal with one or more proposed time slots. Participants can accept, counter, or reject…
- `respond_to_proposal` — Accept, counter, or reject a meeting proposal. When accepting, select a specific slot. When countering, provide new pro…
- `get_proposal` — Retrieve a proposal by ID, optionally including the full negotiation thread.
- `check_consent` — Check whether you have consent to access another principal's data (e.g. availability). The grantee is automatically set…
- `get_network` — Get a summary snapshot of your connection network: total connections, consent counts, recent contacts, and breakdown by…
- `list_connections` — List your network connections with optional filtering by relationship type, status, or name/email search.
- `find_mutual_connections` — Find people connected to ALL specified principals. The authenticated user must be included in principal_ids.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get vennio/scheduling <tool-name>
```