Redirhub Mcp Server

RedirHub MCP Server

[](https://opensource.org/licenses/MIT) [](https://github.com/redirhub/mcp-server/pulls) [](https://modelcontextprotocol.io) [](https://redirhub.com)

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, query analytics — 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.
• Analytics & Logs — Query click statistics and raw access logs directly from your AI assistant.
• Team Collaboration — Multi-member workspace with role-based access control.
• 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 ***

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 | |------|------| | connect-host-tool | Connect a domain to your workspace. Supports root (example.com), subdomain (sub.example.com), and wildcard (*.example.com). Optionally enable or disable short URLs. Returns DNS configuration instructions. | | update-host-tool | Update domain settings (currently HTTPS toggle only) | | refresh-host-tool | Refresh DNS status for 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 |

Account

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

📊 Statistics (read-only)

| Tool | What It Does | |------|------| | get-stats-tool | Get analytics (click) data. Set file/files for per-link stats (totals, daily trend, breakdowns by country/city/browser/device/referrer/proto); omit for org-level stats (total clicks, unique visitors, active/total link counts, breakdowns by file/handler). Supports time_range (7d/30d/90d/thismonth/lastmonth/lifetime) or custom date_from+date_to. Optional handler and limit. | | get-access-logs-tool | Get raw HTTP request logs. Returns individual visit records (timestamp, IP, user agent, country, browser, referrer, etc.). Optional filters: file, time_range/date_from+date_to, country, handler, browser, device, referrer, search (IP or UA). Supports cursor-based pagination. |

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.

⚠️ 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."

> "Show me click stats for the past 30 days."

> "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.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: redirhub
• Source: redirhub/mcp-server
• License: MIT
• Homepage: https://www.redirhub.com

Install and usage instructions live in the source repository linked above.