RedirHub MCP Server

Control every redirect from your AI assistant. Create, update, test, and monitor URL redirects through a standardized protocol — compatible with Claude, Cursor, and any MCP client.

RedirHub is redirect infrastructure. This MCP server gives your AI agents direct access to that infrastructure: manage redirects and short links, update domains, invite team members — all without opening a dashboard.

Features

• AI-Native Redirect Management — Create, update, and test URL redirects through natural language. No dashboard required.
• Custom Short Links — Generate branded short URLs with your own domains. Full alternative to Bitly.
• DNS Verification — Automatic DNS correctness checks so your redirects always resolve.
• Team Collaboration — Multi-member workspace with role-based access control.
• Analytics Ready — Track redirect click performance through the RedirHub dashboard.
• MCP Protocol — Compatible with Claude, Cursor, Cline, and any MCP client.

Endpoint

https://api.redirhub.com/mcp/v1

Authentication

Generate a Workspace API token from dash.redirhub.com (Settings → API Tokens) and pass it as a Bearer token:

Authorization: Bearer rh_xxx...xxxx

Available on all plans, including Free.

Server Info

• Name: Redirect Infra Public API
• Version: 1.0.1
• Transport: Streamable HTTP (JSON-RPC 2.0)

Data Model

Users belong to workspaces (organizations). Workspaces contain custom domains (Hosts) and records (Records, including redirects and short links).

Resources

Read workspace data via URI — append query params as ?key=value.

Redirect Records

URI	Description	Filter Params
redirects://list	List redirect records	filter[host], filter[search], filter[tags], filter[dns_correct], filter[created_after], filter[created_before], sort, per_page, cursor
redirects://{id}	Get a single redirect by hashid	—
redirects://count	Count total and paused redirects	—

Short Links

URI	Description	Filter Params
links://list	List short links	Same as redirects://list
links://{id}	Get a single short link by hashid	—

Domains

URI	Description	Filter Params
hosts://list	List custom domains	filter[search], filter[short_url], sort, per_page, cursor
hosts://{hostname}	Get a domain by hostname	—

Workspace & Members

URI	Description
workspace://current	Current workspace info
members://list	List workspace members
members://{user_id}	Get a member by UUID

Account

URI	Description
account://me	Current user profile

Catalogs

URI	Description
plugins://catalog	Available redirect plugins
record-types://catalog	Available redirect types and routing strategies

Tools

Record Management

Tool	What It Does
create-redirect-tool	Create a redirect record
create-link-tool	Create a short link (requires host + destination)
update-record-tool	Update any record (redirect or short link) by hashid
delete-record-tool	Delete any record (redirect or short link) by hashid

Domain Management

Tool	What It Does
update-host-tool	Update domain settings
refresh-host-tool	Refresh DNS status
create-host-link-tool	Enable domain for short links
delete-host-link-tool	Disable short links on a domain

Workspace & Members

Tool	What It Does
add-member-tool	Invite a new member
update-member-tool	Update member role
remove-member-tool	Remove a member
update-workspace-tool	Update workspace settings

Bulk Operations

Tool	What It Does
bulk-update-records-tool	Apply field changes across records
bulk-delete-records-tool	Delete records by source_urls[] (array of source URLs)
bulk-import-tool	Import records from JSON rows[]

Bulk import format: Each row: {url, destination, type?, handler?, title?, description?, tags?, destinations?}. handler is "redirect" or "short-url". Supports mode=create|upsert and dry_run.

Account

Tool	What It Does
update-account-tool	Update user profile

⚠️ Bulk Operation Safety

For bulk-update-records-tool, bulk-delete-records-tool, and bulk-import-tool:

1. ALWAYS invoke first with dry_run: true to preview the affected count.
2. Display the affected count to the user.
3. Only re-invoke with dry_run: false after explicit user confirmation.

Quick Start

1. Get Your API Token

Sign up at redirhub.com and create a Workspace API token from dash.redirhub.com Settings → API Tokens.

2. Configure Your MCP Client

Add to your client config — the endpoint accepts standard MCP HTTP transport:

{
  "mcpServers": {
    "redirhub": {
      "url": "https://api.redirhub.com/mcp/v1",
      "headers": {
        "Authorization": "Bearer rh_YOUR_API_TOKEN"
      }
    }
  }
}

Works with Claude Desktop, Cursor, and any MCP-compatible HTTP client.

3. Use It

Once connected, tell your AI agent what you need:

"Create a 301 redirect from /old-blog to /blog on my domain."

"List all short links on my marketing domain."

"Import these 500 URLs from this JSON into my workspace."

Documentation

• API Reference — Full RedirHub API docs
• dash.redirhub.com — Web dashboard
• MCP Specification — Protocol docs

---

Built by RedirHub — redirect infrastructure for teams that can't afford broken links.