MCP.Market

Opn MCP server

by ysalitrynskyi·io.github.ysalitrynskyi/opn-mcp·v1.2.0·2 stars

MCP server for opn.onl: shorten links, analytics, branded QR codes, and link management.

B78/100grade B
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
Growing

2 stars31 downloads/wk

Reviews

Write one

Nobody has reviewed Opn yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Opn tools (24, 6 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • add_tags_to_link

    Attach one or more existing tags to a link.

  • build_utm_url

    Append UTM campaign parameters to a URL. Returns the tagged URL (does not create a link).

  • check_alias_available

    Check whether a custom alias/slug is available before shortening with it.

  • check_url_health

    Check whether a destination URL is reachable (status + timing) before shortening it.

  • clone_link

    Duplicate an existing link (same destination and settings) under a fresh short code.

  • create_folderwrite action

    Create a folder for grouping links.

  • create_tagwrite action

    Create a tag for organizing links.

  • delete_linkwrite action

    Delete a short link.

  • export_links_csv

    Export all your links as CSV (returns the raw CSV text).

  • get_dashboard_stats

    Get account-wide analytics across all your links: totals, top links, and aggregate click breakdowns.

  • get_link_routing_rules

    Get the smart-routing rules for a link (device/OS/country/language targeting and A/B weighting).

  • get_link_stats

    Get click analytics for a link (clicks, unique visitors, geography, cities, devices, browsers, OS, referrers).

  • get_qr_code

    Get the QR code for a link, optionally branded with a colour, centre logo, and PNG/SVG format.

  • list_folders

    List your folders (each with its link count).

  • list_links

    List your short links (most recent first). Filter by folder, tag or free-text search.

  • list_tags

    List your tags (each with its link count).

  • move_links_to_folder

    Move one or more links into a folder.

  • preview_url_metadata

    Fetch Open Graph metadata (title, description, image, site name) for a URL — handy for auto-titling a link before shortening it.

  • remove_tags_from_linkwrite action

    Detach one or more tags from a link.

  • set_link_routing_rules

    Replace ALL smart-routing rules for a link. Each rule sends visitors matching the given device/OS/country/language to its destination; empty match fields mean 'any'. Send an empty array to clear all rules.

  • shorten_urlwrite action

    Create a short link on opn.onl. Supports scheduling, click limits, folders, tags and one-time (burn-after-reading) links. Returns the short URL and its code.

  • shorten_urls_bulk

    Shorten many URLs in one call. Returns the created links plus any per-URL errors.

  • toggle_link_pin

    Pin or unpin a link (pinned links surface first in the dashboard). Toggles the current state.

  • update_linkwrite action

    Update a link's destination, title, notes, scheduling, click limit, folder or protections. Use the remove_* flags to clear a field.

Public scan report

scanner v0.1.9 · 2026-09-26 · same rubric, same numbers if you re-run it

no findings
  • Code scan4 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 71 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Opn compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 57% of 48,255 servers
Tools
24
the typical server has 7
Tools that change things
25%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
2
more than 75% of 28,688 servers
Downloads a week
31
more than 19% of 12,191 servers with a package

What its tools let an agent do: 13 read · 4 create · 5 change · 2 delete

Install Opn in Claude Code, Cursor or VS Code

Runs npx -y opn-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add opn-mcp -- npx -y opn-mcp
Add to Cursor

What the publisher says

From the Opn repository's README, as published. We do not edit it. Read it on GitHub

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.

Works against the hosted service or your own self-hosted instance.

Setup

1. Get an API key

On your opn.onl instance, go to Settings → API Keys, create a key, and copy it (it starts with opn_ and is shown once).

2. Add the server to your MCP client

Claude Desktop — edit claudedesktopconfig.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "opn": {
      "command": "npx",
      "args": ["-y", "opn-mcp"],
      "env": {
        "OPN_API_KEY": "opn_your_key_here"
      }
    }
  }
}

Restart your client. That's it — it talks to the hosted API (https://l.opn.onl) by default.

Prefer to run from source? Swap the args for the GitHub build — same config:

"args": ["-y", "github:ysalitrynskyi/opn-mcp"] (it builds on install).

Self-hosted instance

Point OPNBASEURL at your own instance's API host:

{
  "mcpServers": {
    "opn": {
      "command": "npx",
      "args": ["-y", "opn-mcp"],
      "env": {
        "OPN_API_KEY": "opn_your_key_here",
        "OPN_BASE_URL": "https://l.your-domain.com"
      }
    }
  }
}

Configuration

Tools

Links

Analytics

QR & URL helpers

Tags & folders

Example prompts

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Opn: common questions

Is Opn MCP server safe?
Mostly: it is graded B (78/100). Read the Opn safety report
How do I install Opn?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Opn need an API key?
Yes. The registry entry asks for OPN_API_KEY.
Is Opn maintained?
The last commit was 110 days ago (2026-07-17). The latest release is v1.2.0.
How does Opn compare with other MCP servers?
safety score 78/100 (higher than 57% of 48,255 servers); tools 24 (the typical server has 7); tools that change things 25% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.