Whooshly for AI agents

Connect Whooshly to Claude, ChatGPT, and any MCP client

Create short links, dynamic QR codes, UTM templates, and hosted vCards — and read back real click and scan analytics — right inside your AI assistant. One hosted MCP endpoint, no server to run.

MCP endpoint https://app.whooshly.co/api/mcp Mint an agent token

Three ways to connect

Claude.ai & ChatGPT

Add a custom connector and paste the URL. The client runs OAuth in your browser — approve it and the tools appear. Nothing to install.

https://app.whooshly.co/api/mcp

Claude Code

One command adds the server; authenticate with /mcp, or pass a bearer header.

claude mcp add whooshly --transport http \
  https://app.whooshly.co/api/mcp

Claude Desktop & stdio clients

Use the open-source whooshly-mcp bridge (zero dependencies). Add it to claude_desktop_config.json:

{
  "mcpServers": {
    "whooshly": {
      "command": "npx",
      "args": ["-y", "whooshly-mcp"],
      "env": { "WHOOSHLY_TOKEN": "your-agent-token" }
    }
  }
}

Get connected in three steps

1

Sign in and mint an agent token

Open app.whooshly.co, go to Agents, and create a new token. Copy it — it's shown once.

2

Add the connector

Point your client at https://app.whooshly.co/api/mcp. Claude.ai and ChatGPT connect by URL (with a browser OAuth approval); Claude Desktop uses the npx whooshly-mcp bridge with your token.

3

Ask it to create a link

Try "Shorten this URL and show me the QR code." The tools act on your own Whooshly account and return real short links and analytics.

The tools your assistant gets

Eleven tools. Reads are annotated read-only; writes create data on your own account only and are daily-rate-limited.

Tool What it does Access
get_billing_status Check whether the account has unlocked Core / Pro any
create_link Create a short link → id, slug, short URL Core
list_links List your links, newest first (cursor-paged) Core
get_link_stats Exact click/scan totals + daily series for a link Core
create_qr Create a dynamic QR code, returned as a scannable PNG Core
get_qr Re-fetch a saved QR code as a PNG Core
create_utm Save a reusable UTM template Core
list_utm List saved UTM templates Core
create_vcard Create a hosted digital business card (vCard) page Core
search Search your links by slug or destination (deep research) Core
fetch Fetch full details of one link by id (deep research) Core

Try it in a sentence

Shorten https://example.com/2026-summer-launch with the slug summer26 and show me the QR code.
Create a UTM template called paid-social with source instagram, medium cpc, campaign summer-launch.
How many clicks did my summer26 link get this week?
Make a vCard for Jane Doe, Head of Growth at Acme, jane@acme.com.

Whooshly for AI agents – FAQ

Which AI clients can connect to Whooshly?

Any Model Context Protocol (MCP) client. Claude.ai (web, desktop, mobile) and ChatGPT connect directly by URL. Claude Code connects with one `claude mcp add` command. Claude Desktop and other stdio-only clients connect through the open-source `whooshly-mcp` npm bridge.

What is an agent token and where do I get one?

Every tool acts on your own Whooshly account, so the connection is authenticated. Sign in at app.whooshly.co, open Agents, and mint a token (shown once). URL-based clients can instead approve access through a browser OAuth flow — no token to copy.

Do I need to pay to use the AI tools?

Reads and writes require the one-time Core unlock — the same pay-once purchase that unlocks the app. There's no subscription. The get_billing_status tool works on any account so an agent can check entitlement before it acts.

Is my data safe?

Every tool operates only on your own account (never other users' data), writes are rate-limited and non-destructive, and you can revoke any agent token or OAuth grant at any time from the Agents screen. The npm bridge is zero-dependency and open source, so its ~100 lines are easy to audit.

Do I have to install anything?

No, for URL-based clients. The MCP server is hosted at https://app.whooshly.co/api/mcp; claude.ai and ChatGPT just need the URL. The npm package exists only for stdio clients (like Claude Desktop) and for npx convenience.

Give your AI assistant real links.

Connect Whooshly to Claude or ChatGPT and create campaign links from a conversation. Pay once.

Get Whooshly – $49