Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.ysalitrynskyi/opn-mcp

NPM · OPN-MCP · SCANNED AUG 3

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

Available components

+20 this week 66 Trust /100
Trust breakdown (6 categories)

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. How we score →

Supply Chain Security87
  • No malware found by supply-chain analysis.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability81
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 1621 tokens (~67/item across 24 items; 24 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage99
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 98% of tool parameters carry a description.Partial
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

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

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · opn-mcp

# add to Claude Code
claude mcp add ysalitrynskyi-opn-mcp -- npx -y opn-mcp
# add to Codex CLI
codex mcp add ysalitrynskyi-opn-mcp -- npx -y opn-mcp
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ysalitrynskyi-opn-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "opn-mcp"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add ysalitrynskyi-opn-mcp --command npx --arg -y --arg opn-mcp
# ~/.hermes/config.yaml
mcp_servers:
  ysalitrynskyi-opn-mcp:
    command: "npx"
    args: ["-y", "opn-mcp"]
// mcp.json
{
  "mcpServers": {
    "ysalitrynskyi-opn-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "opn-mcp"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 2 Aug 26 +45
    • Provenance: unverified → fail security
    • Known CVEs: unverified → partial security
    • Install scripts: unverified → pass security
    • Malware scan: unverified → pass security
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • Tool coverage: 100 → unverified functional
    • Schema quality: unverified → excellent functional
    • License: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Maintenance: unverified → pass functional
    • MCP protocol: unverified → pass functional
    • First check of Schema quality: unverified functional
    • Licence: MIT functional
  • 31 Jul 26 −7
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 30 Jul 26 −18
    • Malware scan: pass → unverified security
  • 27 Jul 26 46

    First indexed and scored.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 95 packages

95 packages in the resolved dependency tree · 95 deprecated · 29 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 24 exposed · ~1,621 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
add_tags_to_link ~42

Attach one or more existing tags to a link.

NameTypeReqDescription
idintegeryesThe link id
tag_idsarrayyesTag ids to attach

No output schema declared.

No examples provided.

build_utm_url ~128

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

NameTypeReqDescription
urlstringyesThe base URL to tag
utm_campaignstringutm_campaign, e.g. launch-2026
utm_contentstringutm_content (A/B variant)
utm_mediumstringutm_medium, e.g. email
utm_sourcestringutm_source, e.g. newsletter
utm_termstringutm_term (paid-search keyword)

No output schema declared.

No examples provided.

check_alias_available ~37

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

NameTypeReqDescription
aliasstringyesThe custom alias / slug to check

No output schema declared.

No examples provided.

check_url_health ~36

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

NameTypeReqDescription
urlstringyesThe URL to check

No output schema declared.

No examples provided.

clone_link ~38

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

NameTypeReqDescription
idintegeryesThe id of the link to clone

No output schema declared.

No examples provided.

create_folder ~48

Create a folder for grouping links.

NameTypeReqDescription
colorstringHex colour for the folder, e.g. 2f37d8 (optional)
namestringyesFolder name

No output schema declared.

No examples provided.

create_tag ~48

Create a tag for organizing links.

NameTypeReqDescription
colorstringHex colour for the tag, e.g. 2f37d8 (optional)
namestringyesTag name

No output schema declared.

No examples provided.

delete_link ~23

Delete a short link.

NameTypeReqDescription
idintegeryesThe link id

No output schema declared.

No examples provided.

export_links_csv ~22

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

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_dashboard_stats ~29

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

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

get_link_routing_rules ~43

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

NameTypeReqDescription
idintegeryesThe link id

No output schema declared.

No examples provided.

get_link_stats ~67

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

NameTypeReqDescription
daysintegerWindow in days to aggregate over (optional; server default is 30)
idintegeryesThe link id

No output schema declared.

No examples provided.

get_qr_code ~89

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

NameTypeReqDescription
colorstringHex foreground colour, e.g. 2f37d8
formatstringImage format (default png)
idintegeryesThe link id
logobooleanOverlay the brand logo in the centre

No output schema declared.

No examples provided.

list_folders ~19

List your folders (each with its link count).

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_links ~100

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

NameTypeReqDescription
folder_idintegerOnly links in this folder id
limitintegerMax links to return (server default applies if omitted)
offsetintegerPagination offset
searchstringFilter by text in the URL, title, notes or code
tag_idintegerOnly links carrying this tag id

No output schema declared.

No examples provided.

list_tags ~18

List your tags (each with its link count).

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

move_links_to_folder ~45

Move one or more links into a folder.

NameTypeReqDescription
folder_idintegeryesDestination folder id
link_idsarrayyesLink ids to move into the folder

No output schema declared.

No examples provided.

preview_url_metadata ~50

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

NameTypeReqDescription
urlstringyesThe URL to inspect

No output schema declared.

No examples provided.

remove_tags_from_link ~42

Detach one or more tags from a link.

NameTypeReqDescription
idintegeryesThe link id
tag_idsarrayyesTag ids to remove

No output schema declared.

No examples provided.

set_link_routing_rules ~81

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.

NameTypeReqDescription
idintegeryesThe link id
rulesarrayyesThe full rule set (replaces any existing rules)

No output schema declared.

No examples provided.

shorten_url ~260

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.

NameTypeReqDescription
aliasstringCustom alias / slug (optional). Use check_alias_available first to avoid collisions.
burn_after_readingbooleanOne-time link: destroy it after the first successful visit (optional)
expires_atstringISO-8601 timestamp after which the link stops working (optional)
folder_idintegerPlace the link in this folder id (optional)
max_clicksintegerDeactivate the link after this many clicks (optional)
notesstringPrivate notes for the link (optional)
passwordstringPassword-protect the link (optional)
safe_link_interstitialbooleanShow a safety interstitial page before redirecting (optional)
starts_atstringISO-8601 timestamp before which the link is inactive (optional)
tag_idsarrayTag ids to attach to the link (optional)
titlestringPrivate title for the link (optional)
urlstringyesThe destination URL to shorten

No output schema declared.

No examples provided.

shorten_urls_bulk ~62

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

NameTypeReqDescription
folder_idintegerPlace all created links in this folder id (optional)
urlsarrayyesDestination URLs to shorten (up to 500)

No output schema declared.

No examples provided.

toggle_link_pin ~41

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

NameTypeReqDescription
idintegeryesThe link id

No output schema declared.

No examples provided.

update_link ~253

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

NameTypeReqDescription
bio_visiblebooleanShow/hide this link on your public link-in-bio page
burn_after_readingbooleanToggle one-time (burn-after-reading) behaviour
expires_atstringNew ISO-8601 expiry timestamp
folder_idintegerMove the link to this folder id
idintegeryesThe link id
max_clicksintegerNew maximum click count
notesstringNew private notes
passwordstringNew password
remove_expirationbooleanClear the expiry so the link never expires
remove_max_clicksbooleanClear the click limit
remove_passwordbooleanRemove password protection
remove_starts_atbooleanClear the activation timestamp
safe_link_interstitialbooleanToggle the safety interstitial page
starts_atstringNew ISO-8601 activation timestamp
titlestring
urlstringNew destination URL

No output schema declared.

No examples provided.