Agent and MCP
An AI agent that supports MCP can set up Toldbird for you. It needs a token from your account. This feature is on the Pro plan.
What an agent can do
An agent can write setup only. It cannot read your transcripts, recaps, chat, notes or calendar events.
| Tool | What it does |
|---|---|
toldbird_overview | Reads your modes, kind profiles, contexts, topics and plans for the next 14 days, and how many items wait for your approval. An agent calls this first. |
context_questions | Lists what Toldbird needs to know about you for a mode, and which items are present, waiting or missing. It writes nothing. |
set_kind_profile | Writes the About you text for a kind and, optionally, its default mode. |
upsert_context | Creates a context, or updates one the agent made. |
delete_context | Deletes a context the agent made. |
upsert_topic | Creates a topic, or renames one the agent made. |
add_topic_document | Adds pasted text or an https link to a topic as reference material. |
list_modes | Lists your modes. Built-in modes are read-only. |
upsert_mode | Creates a custom mode, or updates one the agent made. |
plan_meeting | Plans a meeting with no calendar event. |
list_planned_meetings | Lists planned meetings in a time range. |
cancel_planned_meeting | Deletes a planned meeting the agent made and that has not started. |
What you approve
Whatever an agent writes for these items waits for you:
- the About you text of a kind
- context excerpts
- plan text (goal, talking points, asks, links)
Toldbird does not use any of it in a meeting until you approve it. An agent cannot approve anything.
- Approve a planned meeting from the menu bar panel: Approve & start on the meeting.
- Approve About you text and context excerpts in Settings. The menu bar panel shows “N items from your agent to review” when something waits.
Topic documents and custom modes do not wait. Toldbird treats topic documents as reference data, never as instructions. A custom mode is used as soon as it matches a meeting, and its coaching text comes from the built-in mode it starts from.
An agent can change only what it created. Anything you wrote, edited or approved stays yours, and the agent gets a user_owned refusal.
Connect an agent
- Open Settings, then General, then Connect an agent.
- Under New token, name the token, choose when it expires (30, 90 or 365 days) and press Create.
- Copy the token. Toldbird shows it once.
- Copy the line under Add Toldbird to your agent and add it to your agent.
For Claude Code the line looks like this, with your own token in place of YOUR_TOKEN:
claude mcp add --transport http toldbird https://api.toldbird.com/mcp --header "Authorization: Bearer YOUR_TOKEN"
Any agent that speaks MCP over HTTP works the same way: the server address is https://api.toldbird.com/mcp and the token goes in the Authorization header.
You can have up to 5 live tokens. The list shows when each was last used and how many writes it made in the last 7 days. Press Revoke to stop a token at once.
A token stops working when you revoke it, when it expires, when you sign out everywhere, and when your plan is no longer Pro.
Privacy
Toldbird stores only a hash of each token. Each agent call is logged with ids and the result, never content.