MCP server for URL shortening, QR codes, and UTM. Use Whooshly from Claude, ChatGPT, and any MCP client.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add whooshly --env WHOOSHLY_TOKEN='<WHOOSHLY_TOKEN>' -- npx -y whooshly-mcp~/.codex/config.toml
[mcp_servers.whooshly]
command = "npx"
args = ["-y", "whooshly-mcp"]
env = { WHOOSHLY_TOKEN = "<WHOOSHLY_TOKEN>" }
# codex mcp add whooshly --env WHOOSHLY_TOKEN='<WHOOSHLY_TOKEN>' -- npx -y whooshly-mcp~/.cursor/mcp.json
{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp"
],
"env": {
"WHOOSHLY_TOKEN": "<WHOOSHLY_TOKEN>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"whooshly": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"whooshly-mcp"
],
"env": {
"WHOOSHLY_TOKEN": "<WHOOSHLY_TOKEN>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp"
],
"env": {
"WHOOSHLY_TOKEN": "<WHOOSHLY_TOKEN>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp"
],
"env": {
"WHOOSHLY_TOKEN": "<WHOOSHLY_TOKEN>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"whooshly-mcp"
],
"env": {
"WHOOSHLY_TOKEN": "<WHOOSHLY_TOKEN>"
}
}
}
}Remote
claude mcp add --transport http whooshly https://app.whooshly.co/api/mcp~/.codex/config.toml
[mcp_servers.whooshly]
url = "https://app.whooshly.co/api/mcp"
# codex mcp add whooshly --url https://app.whooshly.co/api/mcp~/.cursor/mcp.json
{
"mcpServers": {
"whooshly": {
"url": "https://app.whooshly.co/api/mcp"
}
}
}.vscode/mcp.json
{
"servers": {
"whooshly": {
"type": "http",
"url": "https://app.whooshly.co/api/mcp"
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"whooshly": {
"httpUrl": "https://app.whooshly.co/api/mcp"
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"whooshly": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://app.whooshly.co/api/mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"whooshly": {
"url": "https://app.whooshly.co/api/mcp"
}
}
}Environment variables
WHOOSHLY_TOKEN
Replace the placeholders with your own credentials and keep them out of version control.