Whooshly MCP server

Whooshly MCP

Give your AI assistant a campaign-link toolkit. Whooshly exposes a hosted Model Context Protocol server so Claude, ChatGPT, and any MCP client can create short links, dynamic QR codes, UTM templates, hosted vCard pages, and landing pages with lead capture – and read back real click/scan analytics – directly from a conversation.

"Shorten this launch URL, make a QR for the flyer, and save a UTM template for the paid-social campaign" → three tools, one message, links you actually own.

• 🔗 Short links on whooshly.co with live click tracking
• 🟧 Dynamic QR codes returned as scannable PNGs, right in the chat
• 🏷️ UTM templates you can reuse across campaigns
• 📇 Hosted vCard digital business cards
• 📊 Real analytics – exact click/scan totals and daily series per link
• 💸 Pay once. Unlock the core toolkit for a one-time price – no subscription. See pricing →

The server is hosted – there's nothing to run for URL-based clients. This npm package is a small stdio bridge for clients that don't yet speak remote MCP (e.g. Claude Desktop) and for npx convenience.

1. Get an agent token

Every tool acts on your Whooshly account, so you need a token:

1. Sign in at app.whooshly.co
2. Open Agents → New token
3. Copy the token (shown once)

Reads and writes require the one-time Core unlock; getbillingstatus works on any account so an agent can check before it acts.

2. Connect

Claude.ai / Claude (web, desktop, mobile) – by URL, no install

Add a Custom Connector pointing at the remote server. Claude runs the OAuth flow in-browser; approve it and the tools appear.

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

Settings → Connectors → Add custom connector → paste the URL.

ChatGPT – by URL

Add a connector / custom MCP server with the same URL:

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

Claude Code – one command

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

Then authenticate with /mcp inside Claude Code, or pass a token header:

claude mcp add whooshly --transport http https://app.whooshly.co/api/mcp \
  --header "Authorization: Bearer $WHOOSHLY_TOKEN"

Claude Desktop (or any stdio client) – via this bridge

For clients that only speak stdio, use this package. Add it to your claudedesktopconfig.json:

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

That's it – restart the client and the Whooshly tools are available.

Tools

Shortened. The full README is on GitHub.