Opn MCP

An MCP server for opn.onl - the open-source, self-hostable URL shortener. It lets AI assistants (Claude Desktop, Cursor, etc.) shorten links, read analytics, generate QR codes, and manage links in natural language. Its 15 documented tools cover url, shorten, links, check. It runs locally over stdio via the published package.

People connecting data & analytics tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-07-17 · ★ 2 · #49 OF 75 MAINTAINED DATA & ANALYTICS · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Opn MCP

before you install - you'll need

Set OPN_API_KEY, OPN_BASE_URL before connecting.

Claude Code

claude mcp add ysalitrynskyi-opn-mcp -- npx -y opn-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "ysalitrynskyi-opn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "opn-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package opn-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.ysalitrynskyi is GitHub-verified and matches the repo owner

03 · What Opn MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list your links (limit, offset, search, folder or tag filter), update destination, title, notes, scheduling, click limit, folder or protections, delete a link, and check whether a custom alias is free before using it.

Capability map

Tools grouped from the project's README - what Opn MCP lets an agent do.

read & search

3 tools - e.g. Per-link analytics (clicks, unique visitors, geo, cities, devices, browsers, OS, referrers); optional days window; Account-wide analytics across all your links; Get a link's QR image - optional brand…

get_link_stats · get_dashboard_stats · get_qr_code

Shorten

2 tools - e.g. Create a short link - optional alias, title, notes, scheduling (starts_at/expires_at), max_clicks, password, burn-after-reading, folder and tags; Shorten many URLs at once, optionally into a folder

shorten_url · shorten_urls_bulk

Links

2 tools - e.g. List your links (limit, offset, search, folder or tag filter); Move links into a folder

list_links · move_links_to_folder

Check

2 tools - e.g. Check whether a custom alias is free before using it; Check a destination URL is reachable before shortening

check_alias_available · check_url_health

update

1 tool - e.g. Update destination, title, notes, scheduling, click limit, folder or protections; clear fields with remove_ flags

update_link

delete

1 tool - e.g. Delete a link

delete_link

Clone

1 tool - e.g. Duplicate a link under a fresh short code

clone_link

Toggle

1 tool - e.g. Pin or unpin a link

toggle_link_pin

Latest releases

v1.2.0 · 2026-07-17

Synced the server with the full opn.onl API surface: 7 → 24 tools. · Added · Bulk & lifecycle: shorten_urls_bulk, clone_link, toggle_link_pin, check_alias_available, export_links_csv. · get_dashboard_stats…

v1.1.0 · 2026-07-17

Directory and registry support. · Official MCP registry manifest (server.json) and a Dockerfile. · Keyless boot: the server answers initialize and tools/list with no API key · set, so registries can introspect it.…

v1.0.0 · 2026-07-17

Initial release. · Seven tools over stdio: shorten_url, list_links, get_link_stats, · update_link, delete_link, get_qr_code, and check_url_health. · bash · npx opn-mcp

04 · Who maintains Opn MCP

opn-mcp is maintained by ysalitrynskyi. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository: github.com/ysalitrynskyi/opn-mcp
category: data & analytics - ranked #49 of 75 actively-maintained data & analytics servers as of 2026-08-25.
release cadence: 3 releases in the last 90 days (latest 2026-07-17)
registry: io.github.ysalitrynskyi/opn-mcp (active, first published 2026-06-16 · 2 versions)
packages: npm:opn-mcp

06 · Opn MCP FAQ

Is Opn MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-07-17 and it shipped 3 releases in the last 90 days. We re-verify nightly.

What can Opn MCP do?

How do I install Opn MCP?

Run `npx -y opn-mcp`. The README documents 2 environment variables (OPN_API_KEY, OPN_BASE_URL) to set first. Set OPN_API_KEY, OPN_BASE_URL before connecting. You can also paste the ready-made client config above.

Does Opn MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Opn MCP

Alternatives to Opn MCP

Maintained data & analytics servers if Opn MCP isn't the fit.

Pairs well with

Servers that cover what Opn MCP doesn't - only shown when the pairing reason fits the companion.

More data & analytics MCP servers · Zernio · SSH Session MCP · Salesforce Cloud · Picoli MCP

More TypeScript MCP servers · Yuque MCP · Jules Dispatch · Claudia · Stock Scanner MCP · Tunnel MCP · see all