Agent onboarding

Explore endpoints: fetch the OpenAPI spec, or open Scalar. Guide is on the developers page.

Developers: https://topcal.ai/developers

Explore endpoints: https://app.topcal.ai/docs

OpenAPI: https://app.topcal.ai/api/v1/openapi

Discovery manifest: https://app.topcal.ai/.well-known/agent-discovery.json

Remote MCP connector (ChatGPT, Claude — OAuth, no API key): https://mcp.topcal.ai/mcp

Public booker MCP (no auth): https://topcal.ai/api/mcp/public/mcp

Paste into your agent:

Set up https://topcal.ai/INSTALL.md

Install playbook: https://topcal.ai/INSTALL.md

Run this in your terminal:

curl -sL "https://app.topcal.ai/api/agent/install" | bash

HUMANS GET A LINK · AGENTS GET A SKILL

Let your agents handle the booking.

You send a link. Their agent books it.

Paste into your agent

Set up https://topcal.ai/INSTALL.md

Reed

Booker Agent

Message

HOW IT WORKS

One calendar. Two ways in.

HOST

You share a link

01Connect Google or Microsoft.
02Copy your public link: topcal.ai/{workspace}/{you}/{event}.
03Send it. You never pick a time.

THEIR AGENT

It books for them

01Paste the topcal.ai link.
02Read open times from the same calendar.
03Book with the invitee’s email. They confirm a 6-digit code.

YOUR AGENT

It sets you up

01Paste: Set up https://topcal.ai/INSTALL.md
02Approve in the browser. Eligible new accounts get a 14-day trial. No card.
03Connect a calendar. Your agent hands you the link.

ONE ACCOUNT · EVERY CALENDAR YOU RUN

Multiple workspaces. One login.

Own a workspace, be a member of several. Humans and agents are assigned per workspace, so every book keeps its own calendars, routing, and links.

Departments

Sales, success, and recruiting each get their own book — their own event types, routing rules, and booking links under one account.

Agencies

One login for every client. Each client workspace stays isolated, so links, calendars, and agent access never cross books.

Solo → team

Start with your own calendar. Invite the team later and switch workspaces from the dropdown — same you, different username per workspace.

FOR AGENTS

Agents are scoped per workspace. API keys, MCP sessions, and CLI approvals all bind to one workspace — so an agent that manages your sales book can never touch your clients’ books unless you assign it there too.

MEETING INTELLIGENCE

Prepare with context. Schedule with Cal.

BEFORE

Enable guest research on an event type to prepare for meetings. Available data and your business context help Cal suggest relevant questions. Requires an eligible plan and intelligence credits.

ROADMAP

Live coaching, recording imports and native capture are planned. They are not available in the current release or included in any plan.

AFTER

See where bookings come from — human tap or agent — plus no-show rate and this week vs last.

Cal scheduling uses your plan’s included AI calls. Guest research and meeting preparation use intelligence credits. Eligible new accounts receive 100 credits during the 14-day Growth trial. Add your business context for more relevant preparation.

THE PAGE YOU SEND

A booking page is just a URL.

You send topcal.ai/…/30min. A person opens it and taps a time. An agent fetches the same times as JSON and books for them. Walk both sides in the window — it never writes a meeting.

https://topcal.ai/northwind/jordan/30min

30 min with Jordan

Northwind

Story page — not a live calendar. Pick a time. Both tabs share this step.

WHAT TO PASTE

Give your agent the link. Or give it INSTALL.md.

Book on my behalf

Paste the link someone sent you. The agent fetches times and finishes the booking for the human.

Book a time that works for me:
https://topcal.ai/{workspace}/{username}/{eventSlug}

Share my own link

Your agent installs the CLI, you approve in the browser, and it connects the calendar. Eligible new accounts receive a 14-day Growth trial. No card.

Paste into your agent

Set up https://topcal.ai/INSTALL.md

WHERE TO GO

Humans click. Agents fetch.

Public booker URLs stay on topcal.ai. Sign-in and host API live on app.topcal.ai.

Developer docs →

FINDING YOU IS NOT BOOKING YOU

Their agent should leave with a time on the calendar.

Search, a site, and an answer in ChatGPT can surface your business. That is discovery. The close is a hold — booked by the buyer's agent of choice, or by a form you ship on your own page. Same calendars. Same public API. No API key on the booker plane.

YOUR SITE

Build a custom form on the public API

Attach a form to an event type in topcal — company, ARR, team size, whatever you need to qualify. Or skip the hosted page and call the same endpoints from your own landing page. You own the questions. topcal owns free/busy, the email OTP, and the calendar event.

The first GET returns the form definition and required keys. You collect them, then pass customFields on book. Small teams can be sent to Sign up. Enterprise-shaped answers get a real slot.

THEIR AGENT

Book the demo without opening your site

Sales teams keep sending a link and then playing calendar. The buyer already has ChatGPT, Claude, or Cursor. They paste topcal.ai/topcal/hello/30min. The agent fetches open times, asks which one, emails a 6-digit code to the invitee, and finishes the booking for them.

Your AE never picks a slot. The human still confirms the code. Public MCP tools are find_bookable_calendar, get_availability, request_booking_code, confirm_booking.

GET  /api/v1/public/topcal/hello
GET  /api/v1/public/topcal/hello/30min/slots?timezone={IANA}
POST /api/v1/public/topcal/hello/30min/otp
POST /api/v1/public/topcal/hello/30min/book  { startAt, code, invitee: { email, timezone } }

Booking requires the event’s current fields and a valid time slot. Send customFields only when that event defines them.

YOUR PRODUCT

Ship the form

01GET the public event. The JSON includes the form attached to that event type.
02Collect those keys in your own UI — qualify, route, or push self-serve first.
03POST customFields on the same OTP book call. No API key on the booker plane.

THE BUYER

Find, then book

01They found you — search, a site, a teammate, an answer from their agent.
02They paste your topcal.ai link into ChatGPT, Claude, Cursor, or any agent.
03That agent reads times and books on their behalf. They confirm the email code.

YOUR SALES TEAM

A demo is a hold

01Inbound wants a hold, not another form that dies in a queue.
02Qualify on your site. Small teams start self-serve. Enterprise gets a slot.
03The meeting lands on the calendar your AE already connected.

Plan a rollout →INSTALL.md Guest booking skill Developers Host API docs

START WITH YOUR CALENDAR

Start self-serve. Talk with us when you need help.

Eligible new accounts receive a 14-day Growth trial with 100 workspace intelligence credits. No credit card required. After the trial, stay on Free or choose Starter or Growth per connected calendar.

Start free

Planning a team or agency rollout?

Discuss your calendar setup, client workspaces, volume and support needs. Choose an available time on our booking page.

Book a TopCal conversation

QUESTIONS

Frequently asked

What is topcal?

topcal is scheduling software for humans and AI agents on the same calendars. You share a booking link; a visitor taps a time — or their AI agent reads your open times and books on their behalf.

How do AI agents book meetings with topcal?

Anyone pastes your topcal.ai link into ChatGPT, Claude, Cursor, or any agent. The agent fetches open times from the public booker API, picks one with the invitee, and completes the booking. The invitee confirms with a 6-digit code sent by email.

Do agents need an API key to book?

No. Public booker URLs, the public slots endpoint, and the public MCP tools are keyless. Hosts never expose API keys on the booking path.

Which calendars does topcal support?

Google Calendar and Microsoft calendars are supported today. One billable seat covers each connected calendar.

How much does topcal cost?

Free includes calendar connections, 10 original bookings per calendar in a rolling 30-day period, and 25 Cal scheduling AI calls per workspace per month. Starter is $20/calendar/month ($200/year), with intelligence credits purchased separately. Growth is $99/calendar/month ($990/year), including 200 intelligence credits per calendar per month. Eligible new accounts receive a 14-day Growth trial with 100 workspace intelligence credits and no card required; additional workspaces start Free.

Can I manage more than one calendar book?

Yes. One account spans multiple workspaces — your personal book, department books, or agency client books. You can own one workspace and be a member of others, with a separate username in each. Agents are assigned per workspace too.

What counts as a paid seat?

A seat is one connected Google or Microsoft calendar. Billing follows connected calendars automatically: disconnect a calendar and the seat is removed from the next invoice.

Can guests cancel or reschedule?

Yes. Every confirmation email includes a manage link. The guest opens it to cancel or pick a new time, and the host's calendar updates. The same email carries a calendar invite (.ics) with add-to-calendar links for Google, Outlook, and Microsoft 365. Agents can do the same through the public cancel and reschedule endpoints with the token from that email.

Can a team share one booking link?

Yes, on Starter and Growth. Create a team, add members, and share topcal.ai/{workspace}/team/{team}/{event}. Routing is round-robin by default, or least-recently-booked, weighted, or first-available.

Does TopCal join the meeting as a bot?

No. Current TopCal schedules meetings and helps you prepare. Live coaching, recording imports and native capture are roadmap features, not included in any current plan or trial.

STOP PICKING TIMES

Free forever. $20 / connected calendar when you need more.

14-day Growth trial. No credit card. Then Free (10 meetings / calendar / 30 days), or Starter at $20/month or $200/year per connected calendar.