{
  "markdown": "# @filooapp/mcp-server\n\n[![npm version](https://img.shields.io/npm/v/@filooapp/mcp-server.svg)](https://www.npmjs.com/package/@filooapp/mcp-server)\n[![license](https://img.shields.io/npm/l/@filooapp/mcp-server.svg)](./LICENSE)\n\nThe 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.\n\nIf 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.\n\n## What is filoo\n\nfiloo 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.\n\nDocs and pricing: https://filoo.app/api\n\n## Installation\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"filoo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@filooapp/mcp-server\"],\n      \"env\": {\n        \"FILOO_API_KEY\": \"flo_live_xxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. Your agent now has the 8 filoo tools.\n\n### Cursor\n\nIn Cursor settings → MCP, add a new server:\n\n```json\n{\n  \"filoo\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@filooapp/mcp-server\"],\n    \"env\": { \"FILOO_API_KEY\": \"flo_live_xxxxxxxxxxxx\" }\n  }\n}\n```\n\n### Generic MCP client (stdio)\n\n```bash\nFILOO_API_KEY=flo_live_xxxxxxxxxxxx npx -y @filooapp/mcp-server\n```\n\nThe process speaks JSON-RPC over stdio per the MCP spec.\n\n### Local install\n\n```bash\nnpm install -g @filooapp/mcp-server\nFILOO_API_KEY=flo_live_xxxxxxxxxxxx mcp-server-filoo\n```\n\n## Configuration\n\n| Env var | Required | Description |\n|---|---|---|\n| `FILOO_API_KEY` | yes | Your filoo API key, starts with `flo_live_`. Get one at https://filoo.app/dashboard/api (pro, agents, or lifetime tier). |\n| `FILOO_API_BASE` | no | Override the API base URL. Defaults to `https://filoo.app/api/v1`. |\n\n## The 8 tools\n\nEach tool maps 1:1 to a filoo REST endpoint. The descriptions below are what the LLM reads when deciding which tool to call.\n\n### `filoo_me`\nGet the authenticated user's account: tier, usernames, boost credits, and limits.\n\n> **Example prompt:** \"What's my filoo plan and how many links can I still create?\"\n\n### `filoo_usage`\nToday's usage vs. quotas: links created today, API calls today, active link count vs. cap.\n\n> **Example prompt:** \"How close am I to my filoo daily limit?\"\n\n### `filoo_list_usernames`\nList every username you own and which one is primary.\n\n> **Example prompt:** \"List all my filoo usernames.\"\n\n### `filoo_create_link`\nCreate a new short link. Args: `destination` (required), `slug?`, `username?`, `label?`.\n\n> **Example prompt:** \"Shorten https://example.com/very-long-launch-page under my 'agency' username with slug 'q4-launch'.\"\n\n### `filoo_list_links`\nCursor-paginated list of your links, newest first. Args: `limit?` (max 100), `cursor?`.\n\n> **Example prompt:** \"Show me my last 20 filoo links.\"\n\n### `filoo_get_link`\nFetch one link by code. Args: `code` (form `username:slug`).\n\n> **Example prompt:** \"What does filoo link agency:q4-launch point to?\"\n\n### `filoo_update_link`\nRepoint or rename a link without changing its short URL. Args: `code`, `destination?`, `label?`, `active?`.\n\n> **Example prompt:** \"Point filoo link agency:q4-launch to the new landing page at https://example.com/launched.\"\n\n### `filoo_delete_link`\nPermanently delete a short link. Args: `code`.\n\n> **Example prompt:** \"Delete the filoo link agency:old-promo.\"\n\n### `filoo_link_stats`\nClick totals, uniques, bots, top countries, and top sources for a link. Args: `code`.\n\n> **Example prompt:** \"How is filoo link agency:q4-launch performing? Show top countries and sources.\"\n\n## Getting an API key\n\n1. Sign up at https://filoo.app\n2. Upgrade to the **agents** tier (50,000 links, 5,000/day, 1,000 req/min) — it's purpose-built for AI agent workloads. The pro and lifetime tiers also expose the API.\n3. Go to https://filoo.app/dashboard/api and create a key. It starts with `flo_live_`.\n4. Paste it into your MCP client config under `FILOO_API_KEY`.\n\nFull API reference: https://filoo.app/api\n\n## Development\n\n```bash\ngit clone https://github.com/filooapp/mcp-server\ncd mcp-server\nnpm install\nnpm run build\nFILOO_API_KEY=flo_live_xxx node dist/index.js\n```\n\n## License\n\nMIT © 2026 filoo\n",
  "bytes": 4864,
  "sha": "726115b14b6b7aee8847a82e5d875d585cc13715aad634c2586fd6d6a2babaac",
  "repo_slug": "jrlprost/filoo-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_jrlprost_filoo_mcp_829f625d/readme"
}