Server data from the Official MCP Registry
MCP server for opn.onl: shorten links, analytics, branded QR codes, and link management.
MCP server for opn.onl: shorten links, analytics, branded QR codes, and link management.
opn-mcp is a well-structured MCP server for the opn.onl URL shortener with appropriate authentication and secure credential handling. The server properly requires an API key via environment variables, validates inputs with Zod, and implements correct error handling. Minor code quality observations around error message truncation and lazy client initialization do not materially impact security. Supply chain analysis found 5 known vulnerabilities in dependencies (2 critical, 3 high severity). Package verification found 1 issue.
5 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: OPN_API_KEY
Environment variable: OPN_BASE_URL
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-ysalitrynskyi-opn-mcp": {
"env": {
"OPN_API_KEY": "your-opn-api-key-here",
"OPN_BASE_URL": "your-opn-base-url-here"
},
"args": [
"-y",
"opn-mcp"
],
"command": "npx"
}
}
}From the project's GitHub README.
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.
On your opn.onl instance, go to Settings → API Keys, create a key, and copy it (it starts with opn_ and is shown once).
Claude Desktop — edit claude_desktop_config.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.
Not published to npm yet? Use the GitHub source instead — same config, just swap the
args:"args": ["-y", "github:ysalitrynskyi/opn-mcp"](it builds on install).
Point OPN_BASE_URL 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"
}
}
}
}
| Env var | Required | Default | Description |
|---|---|---|---|
OPN_API_KEY | ✅ | — | Your API key (opn_…), from Settings → API Keys |
OPN_BASE_URL | — | https://l.opn.onl | API base URL — set this for a self-hosted instance |
| Tool | Description |
|---|---|
shorten_url | Create a short link (url, optional alias / title / expiry / password) |
list_links | List your links (limit, offset, search) |
get_link_stats | Click analytics for a link (geo, devices, browsers, referrers) |
update_link | Update a link's destination, title, expiry or password |
delete_link | Delete a link |
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 |
npm install
npm run build # tsc → dist/
npm test # vitest
OPN_API_KEY=opn_… npm run dev # run from source (stdio)
MIT © ysalitrynskyi. Part of the opn.onl project.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.