Filoo MCP server

@filooapp/mcp-server

The official MCP server for filoo.app — an AI agent URL shortener with built-in click tracking. Plug this into Claude Desktop, Cursor, or any other Model Context Protocol client and your agent can shorten URLs, manage links, and read scan analytics through 8 first-class tools.

If you are looking for an "MCP server URL shortener", a "Claude URL shortener tool", a "Cursor link shortener", or a way to give an AI agent its own short link namespace, this is it.

What is filoo

filoo is an API-first URL shortener built for both humans and agents. Each link lives under a username (filoo.app/{username}/{slug}), comes with a QR code, and tracks clicks with country, device, referrer, and source breakdowns. The agents tier gives you 50,000 active links, 5,000 new links per day, unlimited usernames, and a 1,000 requests/minute API rate limit — designed so a fleet of agents can hammer the API without throttling.

Docs and pricing: https://filoo.app/api

Installation

Claude Desktop

Edit ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):

{
  "mcpServers": {
    "filoo": {
      "command": "npx",
      "args": ["-y", "@filooapp/mcp-server"],
      "env": {
        "FILOO_API_KEY": "flo_live_xxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop. Your agent now has the 8 filoo tools.

Cursor

In Cursor settings → MCP, add a new server:

{
  "filoo": {
    "command": "npx",
    "args": ["-y", "@filooapp/mcp-server"],
    "env": { "FILOO_API_KEY": "flo_live_xxxxxxxxxxxx" }
  }
}

Generic MCP client (stdio)

FILOO_API_KEY=flo_live_xxxxxxxxxxxx npx -y @filooapp/mcp-server

The process speaks JSON-RPC over stdio per the MCP spec.

Local install

npm install -g @filooapp/mcp-server
FILOO_API_KEY=flo_live_xxxxxxxxxxxx mcp-server-filoo

Configuration

The 8 tools

Each tool maps 1:1 to a filoo REST endpoint. The descriptions below are what the LLM reads when deciding which tool to call.

filoo_me

Get the authenticated user's account: tier, usernames, boost credits, and limits.

Example prompt: "What's my filoo plan and how many links can I still create?"

filoo_usage

Today's usage vs. quotas: links created today, API calls today, active link count vs. cap.

Example prompt: "How close am I to my filoo daily limit?"

filoolistusernames

List every username you own and which one is primary.

Example prompt: "List all my filoo usernames."

filoocreatelink

Create a new short link. Args: destination (required), slug?, username?, label?.

Example prompt: "Shorten https://example.com/very-long-launch-page under my 'agency' username with slug 'q4-launch'."

filoolistlinks

Cursor-paginated list of your links, newest first. Args: limit? (max 100), cursor?.

Example prompt: "Show me my last 20 filoo links."

filoogetlink

Fetch one link by code. Args: code (form username:slug).

Example prompt: "What does filoo link agency:q4-launch point to?"

filooupdatelink

Repoint or rename a link without changing its short URL. Args: code, destination?, label?, active?.

Example prompt: "Point filoo link agency:q4-launch to the new landing page at https://example.com/launched."

filoodeletelink

Permanently delete a short link. Args: code.

Shortened. The full README is on GitHub.