Opn MCP Server

by ysalitrynskyiio.github.ysalitrynskyi/opn-mcpv1.2.0

Model Context Protocol server for opn.onl — the open-source, self-hostable URL shortener. Lets AI assistants shorten links, read analytics, and manage links.

2Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Opn MCP server

claude mcp add opn -e OPN_API_KEY='<opn-api-key>' -- npx -y opn-mcp

{
  "mcpServers": {
    "opn": {
      "command": "npx",
      "args": [
        "-y",
        "opn-mcp"
      ],
      "env": {
        "OPN_API_KEY": "<opn-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "opn": {
      "command": "npx",
      "args": [
        "-y",
        "opn-mcp"
      ],
      "env": {
        "OPN_API_KEY": "<opn-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "opn": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "opn-mcp"
      ],
      "env": {
        "OPN_API_KEY": "<opn-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "opn": {
      "command": "npx",
      "args": [
        "-y",
        "opn-mcp"
      ],
      "env": {
        "OPN_API_KEY": "<opn-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
OPN_API_KEY	yes	yes	Your opn.onl API key (create one under Settings → API Keys).
OPN_BASE_URL	—	—	API base URL. Set this to your own instance's API for a self-hosted opn.onl.

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-17 · 3mo ago · GitHub
Latest release
2026-07-17 · 3mo ago · GitHub · v1.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-12 · 3mo ago · official registry · v1.2.0

FAQ

›How do I install the Opn MCP server in Claude Code?

Run: claude mcp add opn -e OPN_API_KEY='<opn-api-key>' -- npx -y opn-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Opn require an API key?

Yes. It expects OPN_API_KEY, of which 1 is a secret.

›Can I use Opn as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Opn in the official MCP registry?

Yes, as io.github.ysalitrynskyi/opn-mcp.