Opn MCP server
io.github.ysalitrynskyi/opn-mcp·v1.2.0·2 starsMCP server for opn.onl: shorten links, analytics, branded QR codes, and link management.
2 stars31 downloads/wk
Reviews
Write oneNobody 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 postsRead from the package source without running it. The installed server may list more.
add_tags_to_linkAttach one or more existing tags to a link.
build_utm_urlAppend UTM campaign parameters to a URL. Returns the tagged URL (does not create a link).
check_alias_availableCheck whether a custom alias/slug is available before shortening with it.
check_url_healthCheck whether a destination URL is reachable (status + timing) before shortening it.
clone_linkDuplicate an existing link (same destination and settings) under a fresh short code.
create_folderwrite actionCreate a folder for grouping links.
create_tagwrite actionCreate a tag for organizing links.
delete_linkwrite actionDelete a short link.
export_links_csvExport all your links as CSV (returns the raw CSV text).
get_dashboard_statsGet account-wide analytics across all your links: totals, top links, and aggregate click breakdowns.
get_link_routing_rulesGet the smart-routing rules for a link (device/OS/country/language targeting and A/B weighting).
get_link_statsGet click analytics for a link (clicks, unique visitors, geography, cities, devices, browsers, OS, referrers).
get_qr_codeGet the QR code for a link, optionally branded with a colour, centre logo, and PNG/SVG format.
list_foldersList your folders (each with its link count).
list_linksList your short links (most recent first). Filter by folder, tag or free-text search.
list_tagsList your tags (each with its link count).
move_links_to_folderMove one or more links into a folder.
preview_url_metadataFetch Open Graph metadata (title, description, image, site name) for a URL — handy for auto-titling a link before shortening it.
remove_tags_from_linkwrite actionDetach one or more tags from a link.
set_link_routing_rulesReplace 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 actionCreate 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_bulkShorten many URLs in one call. Returns the created links plus any per-URL errors.
toggle_link_pinPin or unpin a link (pinned links surface first in the dashboard). Toggles the current state.
update_linkwrite actionUpdate 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
- 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
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
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.