Whooshly MCP server
{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp@latest"
],
"env": {
"WHOOSHLY_TOKEN": "<whooshly_token>",
"WHOOSHLY_MCP_URL": "https://...",
"WHOOSHLY_API_TOKEN": "<whooshly_api_token>"
}
}
}
}{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp@latest"
],
"env": {
"WHOOSHLY_TOKEN": "<whooshly_token>",
"WHOOSHLY_MCP_URL": "https://...",
"WHOOSHLY_API_TOKEN": "<whooshly_api_token>"
}
}
}
}{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp@latest"
],
"env": {
"WHOOSHLY_TOKEN": "<whooshly_token>",
"WHOOSHLY_MCP_URL": "https://...",
"WHOOSHLY_API_TOKEN": "<whooshly_api_token>"
}
}
}
}{
"servers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp@latest"
],
"env": {
"WHOOSHLY_TOKEN": "${input:whooshly_token}",
"WHOOSHLY_MCP_URL": "${input:whooshly_mcp_url}",
"WHOOSHLY_API_TOKEN": "${input:whooshly_api_token}"
}
}
},
"inputs": [
{
"id": "whooshly_token",
"type": "promptString",
"description": "Whooshly token",
"password": true
},
{
"id": "whooshly_mcp_url",
"type": "promptString",
"description": "Whooshly mcp url",
"password": true
},
{
"id": "whooshly_api_token",
"type": "promptString",
"description": "Whooshly api token",
"password": true
}
]
}{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp@latest"
],
"env": {
"WHOOSHLY_TOKEN": "<whooshly_token>",
"WHOOSHLY_MCP_URL": "https://...",
"WHOOSHLY_API_TOKEN": "<whooshly_api_token>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y whooshly-mcpversion 1.1.0
What it does
Whooshly exposes tools for creating and managing short links, QR codes, UTM templates, vCards, and landing pages with click/scan analytics. It is for developers who want to add link management and campaign tools to AI assistants like Claude or ChatGPT.
- Create a short link with a custom slug and generate a dynamic QR code for a flyer in a single message.
- Save and reuse UTM templates across paid social campaigns without manual copy-paste.
- Check click and scan analytics for a link to measure campaign performance directly from conversation.
Tools this server exposes
| Tool | Does |
|---|---|
| get_billing_status | Check whether the account has unlocked Core or Pro tier access. |
| create_link | Create a short link on whooshly.co with optional custom slug and get back the short URL and click tracking ID. |
| list_links | List all short links in the account, newest first, with cursor-based pagination. |
| get_link_stats | Retrieve exact click or scan totals and daily series breakdown for a specific link. |
| create_qr | Create a dynamic QR code and return it as a scannable PNG image. |
| get_qr | Retrieve a previously saved QR code as a PNG image. |
| create_utm | Save a reusable UTM template with source, medium, campaign, and other parameters. |
| list_utm | List all saved UTM templates in the account. |
| create_vcard | Create a hosted digital business card page with contact details. |
| create_page | Create a landing page on a custom subdomain with content blocks and lead capture. |
| update_page | Edit a landing page's content blocks, theme, or slug. |
| list_pages | List all landing pages in the account with associated lead counts. |
| get_page | Retrieve a single landing page's content, lead count, and webhook delivery summary. |
| search | Search links by slug or destination URL across the account. |
| fetch | Retrieve full details of a single link by its ID. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.