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, and hosted vCard pages – 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; get_billing_status 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 claude_desktop_config.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

All read tools are annotated readOnlyHint; all write tools are non-destructive and operate only on your own account (openWorldHint: false).

---

Example prompts

Once connected, try:

• "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."

---

Configuration

WHOOSHLY_API_TOKEN is accepted as an alias for WHOOSHLY_TOKEN.

---

How the bridge works

whooshly-mcp reads newline-delimited JSON-RPC from stdin, POSTs each message to the hosted server with your bearer token, and writes the correlated reply to stdout. It has zero npm dependencies (Node 18+ built-ins only), so it's small and easy to audit – the entire bridge is one file: bin/whooshly-mcp.mjs.

The heavy lifting – auth, rate limits, entitlement checks, QR rendering, analytics – all happens server-side on Whooshly. The bridge is a transport shim, nothing more.

---

Links

• Website: https://whooshly.co
• MCP server / connect guide: https://whooshly.co/mcp
• App / dashboard: https://app.whooshly.co
• MCP endpoint: https://app.whooshly.co/api/mcp

License

MIT © Whooshly