Skip to main content

​
Connect an MCP client

  1. Add the MCP server URL above to your assistant. There are steps for Claude, ChatGPT and Gemini.
  2. Sign in to Whirl when the client asks, and approve access.
  3. Ask your assistant something like “What’s on my Whirl task list?”
On team plans, an admin may need to allow custom servers first. See Connect with MCP for details.

​
Use the API

Your app gets a token through the OAuth authorization-code flow with PKCE, with a Whirl user approving access.

​
List your workspaces

These examples assume WHIRL_ACCESS_TOKEN holds your access token.
This needs the workspace:read scope. Use the IDs Whirl returns for later calls. A token issued only for /mcp won’t work for the API.

​
See which operations you can call

This lists the operations your token’s scopes allow. Each call still checks the user’s current access to the workspace or task.

​
Call an operation by name

You can also call any operation by name:
Put the operation’s arguments directly in the JSON body, without an arguments or params wrapper. See the API guide for routes, errors and pagination.

​
Next steps