Server data from the Official MCP Registry
Create short links, fetch click analytics, and generate QR codes via the filoo.app API.
Create short links, fetch click analytics, and generate QR codes via the filoo.app API.
This is a well-structured MCP server for filoo.app with proper authentication, input validation, and secure API interaction patterns. Authentication is required via FILOO_API_KEY environment variable, permissions are narrowly scoped to HTTP API calls to filoo.app, and code quality is high with proper error handling and input validation via Zod schemas. Minor quality improvements around logging and error message handling exist but do not present security risks. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 2 high severity). Package verification found 1 issue.
3 files analyzed · 6 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: FILOO_API_KEY
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-jrlprost-filoo-mcp": {
"env": {
"FILOO_API_KEY": "your-filoo-api-key-here"
},
"args": [
"-y",
"@filooapp/mcp-server"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
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
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.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.
In Cursor settings → MCP, add a new server:
{
"filoo": {
"command": "npx",
"args": ["-y", "@filooapp/mcp-server"],
"env": { "FILOO_API_KEY": "flo_live_xxxxxxxxxxxx" }
}
}
FILOO_API_KEY=flo_live_xxxxxxxxxxxx npx -y @filooapp/mcp-server
The process speaks JSON-RPC over stdio per the MCP spec.
npm install -g @filooapp/mcp-server
FILOO_API_KEY=flo_live_xxxxxxxxxxxx mcp-server-filoo
| Env var | Required | Description |
|---|---|---|
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). |
FILOO_API_BASE | no | Override the API base URL. Defaults to https://filoo.app/api/v1. |
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_meGet 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_usageToday'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?"
filoo_list_usernamesList every username you own and which one is primary.
Example prompt: "List all my filoo usernames."
filoo_create_linkCreate 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'."
filoo_list_linksCursor-paginated list of your links, newest first. Args: limit? (max 100), cursor?.
Example prompt: "Show me my last 20 filoo links."
filoo_get_linkFetch one link by code. Args: code (form username:slug).
Example prompt: "What does filoo link agency:q4-launch point to?"
filoo_update_linkRepoint 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."
filoo_delete_linkPermanently delete a short link. Args: code.
Example prompt: "Delete the filoo link agency:old-promo."
filoo_link_statsClick totals, uniques, bots, top countries, and top sources for a link. Args: code.
Example prompt: "How is filoo link agency:q4-launch performing? Show top countries and sources."
flo_live_.FILOO_API_KEY.Full API reference: https://filoo.app/api
git clone https://github.com/filooapp/mcp-server
cd mcp-server
npm install
npm run build
FILOO_API_KEY=flo_live_xxx node dist/index.js
MIT © 2026 filoo
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.