opn-mcp MCP Server

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.

Local serverstdioMIT

What is the opn-mcp Server?

opn-mcp source profile. From the maintainer documentation: “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.”

Installation

The documented npm package is opn-mcp. The configuration below comes from the maintainer’s example; adapt its paths and account values to your environment.

Configuration values

The example declares OPN_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
shorten_url	Create a short link — optional alias, title, notes, scheduling (starts_at/expires_at), max_clicks, password, burn-after-reading, folder and tags
shorten_urls_bulk	Shorten many URLs at once, optionally into a folder
list_links	List your links (limit, offset, search, folder or tag filter)
update_link	Update destination, title, notes, scheduling, click limit, folder or protections; clear fields with remove_ flags
delete_link	Delete a link
clone_link	Duplicate a link under a fresh short code
toggle_link_pin	Pin or unpin a link
check_alias_available	Check whether a custom alias is free before using it
get_link_stats	Per-link analytics (clicks, unique visitors, geo, cities, devices, browsers, OS, referrers); optional days window
get_dashboard_stats	Account-wide analytics across all your links
get_qr_code	Get a link's QR image — optional brand colour, centre logo, PNG/SVG
check_url_health	Check a destination URL is reachable before shortening
build_utm_url	Append UTM campaign parameters to a URL
preview_url_metadata	Fetch Open Graph metadata (title, description, image) for a URL
move_links_to_folder	Move links into a folder

How to install the opn-mcp Server

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

From the project documentation. Replace placeholders and example paths before connecting.