Opn Mcp
by ysalitrynskyicommunityv1.1.0
An MCP server for opn.onl that lets AI assistants shorten URLs, view link analytics, generate QR codes, and manage links. It works with the hosted opn.onl service or a self-hosted opn instance.
From the registry: MCP server for opn.onl: shorten links, analytics, branded QR codes, and link management.
Install & configure
Prerequisites
- requiredCreate an opn API keyIn your opn.onl instance, go to Settings → API Keys, create an API key, and copy it. The key starts with `opn_` and is shown once.
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `opn-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Create an opn API key** — In your opn.onl instance, go to Settings → API Keys, create an API key, and copy it. The key starts with `opn_` and is shown once.
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","opn-mcp"]
- required environment variables:
- `OPN_API_KEY`: Your opn.onl API key from Settings → API Keys. (example: `<your-opn-api-key>`)
- optional environment variables:
- `OPN_BASE_URL`: API base URL for a self-hosted opn instance. Omit to use the hosted default service. (example: `<your-opn-base-url>`)
Note: Default install path uses the hosted opn API. For self-hosted deployments, set OPN_BASE_URL. The README also mentions a fallback install path if the package is not published to npm yet: use `npx -y github:ysalitrynskyi/opn-mcp` with the same environment variables.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: Default install path uses the hosted opn API. For self-hosted deployments, set OPN_BASE_URL. The README also mentions a fallback install path if the package is not published to npm yet: use `npx -y github:ysalitrynskyi/opn-mcp` with the same environment variables.
Tools (7)
shorten_url
Create a short link with optional alias, title, expiry, or password
list_links
List your links with optional limit, offset, and search
get_link_stats
Get click analytics for a link, including geo, devices, browsers, and referrers
update_link
Update a link's destination, title, expiry, or password
delete_link
Delete a link
get_qr_code
Generate a link's QR image with optional brand colour, centre logo, PNG, or SVG
check_url_health
Check whether a destination URL is reachable before shortening
Environment variables
OPN_API_KEYrequiredAPI key for the opn.onl instanceOPN_BASE_URLAPI base URL for a self-hosted instance; defaults to https://l.opn.onlPackages
opn-mcp
npmv1.1.0transport: stdio
Details
- Language
- JavaScript
- License
- MIT
- Released
- Jun 16, 2026
- Last commit
- Jun 18, 2026
- Registry name
- io.github.ysalitrynskyi/opn-mcp