Rus.sh

Rus.sh MCP server

Make, find, pause and track short links and QR codes from your AI assistant.

Rus.sh is a link shortener with QR codes and click analytics. Its MCP server is hosted, so you don't install or run anything: add the address below to your assistant and sign in.

https://rus.sh/mcp

• Transport: Streamable HTTP
• Sign-in: OAuth 2.1. Your assistant opens Rus.sh, you sign in and choose what it may do. An API key also works.
• Plans: every plan, including Free.
• MCP Registry: sh.rus/mcp

What your assistant can do

Look things up	Make new links	Change and undo
Get account, list links, get link, list QR codes, get QR code, get account / link / QR code analytics	Create link	Update link; archive, restore, pause and resume links; archive and restore QR codes

The assistant works within the permissions you approve and can never permanently delete anything. Every change can be undone.

Connect your assistant

Step-by-step guides with copy buttons are at rus.sh/pages/ai. Signed-in users also have them under user menu → Connect an AI app, which can create an API key and fill it into each command.

Claude (claude.ai and Claude Desktop): Customize → Connectors → Add → Add custom connector. Name it Rus.sh, paste https://rus.sh/mcp, then choose Add and Connect.

ChatGPT: Plugins → Add → Add custom MCP server. Name it Rus.sh, keep OAuth, paste https://rus.sh/mcp, then create it and connect.

Claude Code:

claude mcp add --transport http -s user rus-sh https://rus.sh/mcp

Then type /mcp in Claude Code, choose rus-sh and sign in.

Cursor: use Add to Cursor on rus.sh/pages/ai, or add this to ~/.cursor/mcp.json:

{ "mcpServers": { "rus-sh": { "url": "https://rus.sh/mcp" } } }

VS Code: use Add to VS Code on rus.sh/pages/ai, or add this to .vscode/mcp.json:

{ "servers": { "rus-sh": { "type": "http", "url": "https://rus.sh/mcp" } } }

Codex:

codex mcp add rus-sh --url https://rus.sh/mcp
codex mcp login rus-sh

Antigravity CLI: its own sign-in does not work with Rus.sh yet, so connect it with an API key. Create one in Rus.sh under user menu → Connect an AI app → Antigravity CLI → Use an API key, then copy the filled-in command:

agy mcp add --header "Authorization: Bearer <your key>" rus-sh https://rus.sh/mcp

Gemini CLI (Gemini Code Assist licences):

gemini extensions install https://github.com/sweenttech/rus-sh-mcp

With an API key instead of signing in: create a key at rus.sh/app/api-keys and send it as Authorization: Bearer <key>.

What's in this repository

This repository holds only the files that directories and assistants read: the registry entry (server.json), the Cursor plugin (.cursor-plugin/plugin.json, mcp.json), the Gemini CLI extension (gemini-extension.json) and install notes (llms-install.md). The Rus.sh service itself is not open source.

Support and policies

• Support: [email protected]
• Privacy Policy: https://rus.sh/pages/privacy (section 3.6 covers connected apps)
• Terms of Service: https://rus.sh/pages/terms

The files in this repository are MIT-licensed. The Rus.sh name and logo are trademarks of Sweent LLC.