Skip to content

MCP Tool Catalog

The hosted MCP gateway exposes the Contio User API as a discoverable set of MCP tools. The exact tools available to a session depend on the token's scopes and workspace role.

User tools

Available to any valid user token (PAT or OAuth).

Meetings

  • listMeetings — browse all meetings
  • listUpcomingMeetings — soonest future meetings
  • searchMeetings — filter by keyword, date, participant, or status
  • getMeeting — full details of a specific meeting
  • manageMeetings — create, update, or delete a meeting (set action)

Meeting items

  • listAgendaItems — full agenda of a meeting
  • getAgendaItem — details of one agenda item
  • manageMeetingItems — create, update, delete, or assign an agenda or backlog item (set action and backlog)
  • listBacklogItems — active unscheduled agenda items
  • getBacklogItem — details of one active backlog item
  • listBacklogItemHistory — scheduled or discarded backlog items

Meeting participants

  • listMeetingParticipants — see who is in a meeting
  • manageMeetingParticipants — add, remove, or change a participant's role (set action)

Meeting content

  • listMeetingAttachments — raw files attached to a meeting
  • getMeetingAttachment — metadata for one attachment
  • listMeetingContext — AI context documents on a meeting
  • getMeetingContext — metadata for one context document
  • manageMeetingContent — upload, download, or remove attachments and context (set action and contentType)
  • getMeetingTranscript — transcript of a meeting

Action items

  • listActionItems — follow-up tasks across meetings
  • getActionItem — details of one follow-up task
  • manageActionItems — create, update, or delete a follow-up task (set action)

Canvases

  • listCanvases — list or search canvases by title and body text
  • getCanvas — metadata plus the Markdown body (no ETag)
  • getCanvasContent — Markdown body with the etag needed to rewrite it
  • manageCanvases — create, update metadata, replace the body, or delete a canvas (set action; replaceContent requires If-Match)

Calendar

  • listCalendarEvents — events in a time range
  • getCalendarEvent — details of one event
  • manageCalendarEvents — create a meeting from an event, or link/unlink a meeting (set action)

Meeting templates

  • listMeetingTemplates — available templates for creating a meeting

Contacts

  • listMeetingContacts — workspace contacts for meeting invitations

User tokens and profile

  • getMe — current user and workspace context
  • listUserTokens — active personal access tokens
  • deleteUserToken — revoke a personal access token

Events

Live workspace events are delivered through the contio-events MCP resource, not as a tool. See the Hosted MCP Server guide for how to subscribe.

OAuth discovery

  • exchangeOAuthToken, revokeOAuthToken
  • getOAuthJwks, getOAuthOpenidConfiguration

The /v1/oauth/authorize endpoint is a browser redirect, not an MCP tool. Use the URL in your OAuth 2.1 + PKCE flow and call exchangeOAuthToken to mint tokens.

Grouped manageX tools

Several related write operations are surfaced as a single manageX tool. Callers set action to choose the lifecycle operation and then provide the fields for that action. Some families also use a discriminator field to select a variant:

Tool action values Discriminator Notes
manageMeetings create, update, delete — Lifecycle for meetings themselves.
manageMeetingItems create, update, delete, assign backlog (false for agenda, true for backlog) Agenda and backlog item lifecycle.
manageMeetingParticipants add, remove, updateRole — Participant management.
manageActionItems create, update, delete — Follow-up task lifecycle.
manageCalendarEvents createFromEvent, link, unlink — Calendar-to-meeting integration.
manageMeetingContent upload, download, delete contentType (attachment or context) Raw files and AI context documents.
manageCanvases create, update, replaceContent, delete — Canvas lifecycle. replaceContent is a full-body rewrite guarded by the If-Match ETag from getCanvasContent; a stale ETag returns checksum_mismatch.

Each manageX tool maps to the same underlying v1 REST operationIds that existed before consolidation; only the MCP tool name changed.

Admin tools

Available only when the gateway is called with a workspace API key (cto_wk_v1_). PATs, short-lived access tokens and OAuth tokens do not see these tools, even for a workspace owner or admin.

Workspace

  • getWorkspace, updateWorkspace

Members

  • listWorkspaceMembers, removeWorkspaceMember, updateWorkspaceMemberRole

API keys

  • listWorkspaceApiKeys, deleteWorkspaceApiKey

Webhooks

  • listWorkspaceWebhooks, createWorkspaceWebhook, deleteWorkspaceWebhook
  • reEnableWorkspaceWebhook, rotateWorkspaceWebhookSecret, resendWorkspaceWebhookVerification

Discovering tools at runtime

An MCP client can call tools/list after initialization to see the tools available for the current token. The response includes each tool's name, description, and JSON input schema. The same information is published in the machine-readable manifests:

See the Agent Integration guide for how to consume these artifacts.

Next steps