# io.github.jrlprost/filoo-mcp (npm · @filooapp/mcp-server)

Create short links, fetch click analytics, and generate QR codes via the filoo.app API.

- Trust score: 67/100 (medium)
- Change this week: +21
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `@filooapp/mcp-server`: 67/100 (this document), [markdown](https://verifymcp.io/servers/jrlprost-filoo-mcp/filooapp-mcp-server.md), [page](https://verifymcp.io/servers/jrlprost-filoo-mcp/filooapp-mcp-server)

## Channel facts

- Registry: `npm`
- Package: `@filooapp/mcp-server`
- Version: `0.2.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 74 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 83/100
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 825 tokens (~91/item across 9 items; 9 tools + 0 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add jrlprost-filoo-mcp -- npx -y @filooapp/mcp-server
```

### Codex

```bash
codex mcp add jrlprost-filoo-mcp -- npx -y @filooapp/mcp-server
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jrlprost-filoo-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@filooapp/mcp-server"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add jrlprost-filoo-mcp --command npx --arg -y --arg @filooapp/mcp-server
```

### Hermes

```yaml
mcp_servers:
  jrlprost-filoo-mcp:
    command: "npx"
    args: ["-y", "@filooapp/mcp-server"]
```

### Other

```json
{
  "mcpServers": {
    "jrlprost-filoo-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@filooapp/mcp-server"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 67, +31)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional regression] Security disclosure: fail → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional] First check of Schema quality: unverified
- [functional] Licence: MIT

### 2026-08-01 (score 36, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-07-31 (score 21, −7)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 28, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (9)

### `filoo_me` (~73 tokens)

Get the authenticated filoo user's account: tier (free/solo/pro/agents/lifetime), owned usernames, boost credits, and tier limits (active links cap, links-per-day quota, API rate limit). Call this first when an agent needs to know what username to publish under or how much headroom is left.

### `filoo_usage` (~52 tokens)

Get today's filoo usage versus quotas: links created today, daily creation cap, API calls today, active link count, active link cap, remaining boost credits. Use before bulk-creating links to avoid hitting limits.

### `filoo_list_usernames` (~62 tokens)

List every username the authenticated user owns on filoo, along with which one is primary. Short links live under a username (filoo.app/{username}/{slug}), so this is the canonical way for an agent to discover what namespaces it can publish into.

### `filoo_create_link` (~171 tokens)

Create a new short link on filoo. Returns the short_url (filoo.app/{username}/{slug}) and the link code. Use this whenever an agent needs to shorten a URL, hand a clean URL to a user, generate a QR-friendly link, or attach click tracking to an outbound URL. Counts against the daily creation quota and active link cap — call filoo_usage first if unsure.

Input parameters:

- `destination` (string, required): The long URL to shorten (http or https).
- `label` (string): Optional private label shown only in the dashboard.
- `slug` (string): Optional custom slug like 'spring-sale'. Alphanumeric + hyphens, 1–64 chars. Auto-generated if omitted.
- `username` (string): Username to publish under. Defaults to the user's primary username.

### `filoo_list_links` (~100 tokens)

List the authenticated user's short links, newest first, cursor-paginated. Returns items[] with code, short_url, destination, created_at, plus a cursor to fetch the next page. Use to inventory existing links before creating a new one (avoid duplicates) or to find a link by destination.

Input parameters:

- `cursor` (string): Pagination cursor from a previous call.
- `limit` (integer): Page size, max 100. Default 20.

### `filoo_get_link` (~81 tokens)

Get full details for one filoo short link by code. The code format is 'username:slug' (the colon is URL-encoded automatically). Returns destination, label, active flag, created_at, and short_url.

Input parameters:

- `code` (string, required): Link code in the form 'username:slug', e.g. 'agency:campaign-1'.

### `filoo_update_link` (~130 tokens)

Update a filoo short link in place: change its destination (the previous destination is kept in the audit history so the short URL is safe to repoint), edit its label, or disable/re-enable it with active. The short_url itself never changes. Useful for keeping a stable short URL while migrating the target.

Input parameters:

- `active` (boolean): Set false to disable the link, true to re-enable.
- `code` (string, required): Link code in the form 'username:slug'.
- `destination` (string): New long URL to redirect to.
- `label` (string): New private label.

### `filoo_delete_link` (~76 tokens)

Permanently delete a filoo short link. The short_url stops resolving (returns 404). Click history is preserved on the filoo side for analytics. This action cannot be undone — confirm with the user before calling unless they explicitly asked to delete.

Input parameters:

- `code` (string, required): Link code in the form 'username:slug'.

### `filoo_link_stats` (~80 tokens)

Get click/scan analytics for one filoo short link: total clicks, unique visitors, bot count, top countries, and top traffic sources (including QR-code sources). Use to answer questions like 'how is my campaign link doing?' or to compare performance across links.

Input parameters:

- `code` (string, required): Link code in the form 'username:slug'.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/jrlprost-filoo-mcp/filooapp-mcp-server#diagnostics

## Score history

- 2026-08-03: 67
- 2026-08-02: 67
- 2026-08-01: 36
- 2026-07-31: 21
- 2026-07-30: 28
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/@filooapp/mcp-server
- Socket report: https://socket.dev/npm/package/@filooapp/mcp-server
- Repository: https://github.com/jrlprost/filoo-mcp
- Website: https://filoo.app/
- Changelog RSS feed: https://verifymcp.io/servers/jrlprost-filoo-mcp/filooapp-mcp-server/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/jrlprost-filoo-mcp/filooapp-mcp-server/changelog.json
- HTML version of this page: https://verifymcp.io/servers/jrlprost-filoo-mcp/filooapp-mcp-server