hrva.cc

Create short links, list them and read click statistics from an AI assistant. Sign in with OAuth. Open source, GPL-3.0.

Hosted MCP Server

npx add-mcp 'https://hrva.cc/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Use hrva.cc from your AI assistant

Connect the hrva.cc MCP server, and your assistant can shorten links into your account, list them and check their visits.

What it is

MCP, the Model Context Protocol, is an open standard that lets an AI assistant use tools from other services. The hrva.cc MCP server gives yours three tools, all working in your own account: shorten a URL, list your links, and read a link's visit totals. Admin accounts also see moderation tools; for everyone else they refuse. You connect it once by signing in to hrva.cc, and you can disconnect it at any time. It is free. To shorten links from your own code instead, use the API.

Server URLs

  • Your account

    https://hrva.cc/mcp Copy You sign in with your hrva.cc account. Links go into it, and your assistant can list them and read their visits.

When you add the account URL, your app opens the hrva.cc sign-in page. Sign in as usual, with your password and two-factor code or with Google or GitHub, then allow the app on the consent screen at app.hrva.cc/connect. The screen shows where the app will send you once you allow it; the app chooses its own name, so check that address. When an app is connected for the first time, hrva.cc emails you.

The server without an account is gone. If your AI app shows hrva.cc/mcp/anon as failing or not found, remove it and add https://hrva.cc/mcp. You'll be asked to sign in, or to create a free account.

Set it up

It works with MCP clients that support remote servers with OAuth. Here is how to add it to the common ones.

Claude app (web, desktop, phone)

In Claude on the web or desktop, open Customize → Connectors, add a custom connector and paste this URL. Once it is connected, it works in the Claude phone app too. On Team and Enterprise plans, an owner adds it first under Organization settings → Connectors.

https://hrva.cc/mcp

Claude Code

Run this in a terminal, then run /mcp inside Claude Code to sign in.

$ claude mcp add --transport http hrva https://hrva.cc/mcp

Cursor

Add this to ~/.cursor/mcp.json to use it in every project, or to .cursor/mcp.json for one project. If the file already lists servers, add the hrva entry next to them.

{
  "mcpServers": {
    "hrva": {
      "url": "https://hrva.cc/mcp"
    }
  }
}

VS Code

Run MCP: Add Server from the Command Palette, choose HTTP and paste the account URL. Or add this to .vscode/mcp.json in your project.

{
  "servers": {
    "hrva": {
      "type": "http",
      "url": "https://hrva.cc/mcp"
    }
  }
}

ChatGPT

In ChatGPT on the web, go to Plugins, select +, then Add custom MCP server, and enter this URL. Whether you can add custom servers, and use tools that create links, depends on your ChatGPT plan and workspace settings.

https://hrva.cc/mcp

Tools

ToolWhat it does
Your accounthttps://hrva.cc/mcp
shorten_urlShortens a URL into your account, with an optional alias, visit limit, expiry and tags. Links it creates are tagged ai.
list_linksLists your links, newest first, with search and a tag filter.
link_statsShows a link's clicks, daily unique visitors and bot clicks for the last 7, 30, 90 or 365 days, with its top referrers, countries and devices.

Things to ask it

  • “Shorten https://example.com/autumn-sale as autumn-sale, and make it stop working after 500 visits.” Uses shorten_url
  • “Which of my links are tagged newsletter? Show the newest first.” Uses list_links
  • “How many clicks did hrva.cc/autumn-sale get in the last 30 days, and where did they come from?” Uses link_stats

What your assistant can see

Only what the tools return from your account: your links, with their destinations, visits and status, and for one link at a time its clicks, daily unique visitors and bot clicks, with its top referrers, countries and devices. It can't see who clicked a link, because hrva.cc doesn't store visitors' IP addresses or anything about a single click (how visits are counted). What hrva.cc keeps about the connection itself is in the privacy policy, under AI connectors.