Model Context Protocol (MCP) server

The Whooshly MCP server for 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

Sign in (mint a token for stdio clients)

Claude.ai and ChatGPT connect by URL and approve access in the browser – no token needed. For Claude Desktop and other stdio clients, open app.whooshly.co, go to Agents, and mint a token (shown once).

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.

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

16 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
`update_link`	Edit, archive, or restore one of your links	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
`create_page`	Create a campaign page on your subdomain from content blocks	Core
`update_page`	Edit a page's blocks, theme, or slug; never deletes	Core
`list_pages`	List your campaign pages with lead counts	Core
`get_page`	One page's full content, lead count, and webhook delivery rollup	Core
`search`	Search your links by title, 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 a single 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), and writes are rate-limited and can only create or edit – an agent can never delete anything, never read your leads' personal details (counts only), and never see or change a lead webhook. 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 – $35