Connect Whooshly to an AI agent

Choose the authentication path#

The remote MCP endpoint is https://app.whooshly.co/api/mcp. Clients that support remote OAuth can connect by URL. For local or header-based clients, create a manual token in Agent access.

Connect Claude.ai#

Whooshly is listed in the Claude directory – the fastest path if you use claude.ai. Approve access once in the browser; no token needed.

1. Open the listingGo to claude.ai/directory/whooshly.
2. Click ConnectSign in to Whooshly if prompted, then approve the connection.
3. Ask Claude"Shorten this link and make me a QR code for it." Claude calls the connected Whooshly tools directly.

Create a manual token#

1. Open Connect an AI agentGo to Agent access in the dashboard.
2. Enter a Token labelName the client or machine so it can be identified later.
3. Create tokenCopy it immediately. For security, the full token is shown only once.
4. Add the MCP serverUse the generated command or send the token as an Authorization Bearer header.

claude mcp add --transport http whooshly https://app.whooshly.co/api/mcp --header "Authorization: Bearer <token>"

Example prompts#

Once connected, these work as typed. Each one exercises a different tool.

1. Create a short link"Create a short link for https://whooshly.co/pricing with the slug launch-pricing and the title 'Pricing page'."
2. QR code as an image"Make a QR code for https://example.com/demo and show it to me as an image I can scan." Returns a scannable PNG rendered in the chat.
3. Reusable UTM template"Create a UTM template called 'Newsletter' with source=newsletter, medium=email, campaign=weekly-digest, then list my existing UTM templates."
4. Digital business card"Create a digital business card for Dana Ruiz, Head of Growth, dana@example.com, +1 415 555 0134."
5. Landing page (requires a claimed subdomain)"Create a landing page at /webinar with a headline, a short description, and a form that collects name and work email. Give me the live URL." The account's subdomain must already be claimed once in the app (Pages) before this works.

Manage access#

Agent operations remain gated by the same account plan and ownership rules as the dashboard. Give each client its own label and revoke a token or OAuth client when it is no longer used.