Redirhub Mcp Server
About
RedirHub's MCP server for managing URL redirects, hosts, and domains at scale. Full CRUD + bulk operations, access logs, usage stats, and dry-run safety. 19 tools across 15 resources. Works with Claude, Cursor, and any MCP client. Free tier available.
Details
- Author
- redirhub
- GitHub stars
- 1
- Downloads
- 301
- Categories
- Developer Tools, Infrastructure, Web Scraping, Other, API
Jump to
- AI-native redirect management via natural language
- Custom branded short links with your own domains
- Automatic DNS verification for reliable redirects
- Query click analytics and raw access logs
- Team workspace with role-based access control
- Compatible with any MCP client (Claude, Cursor, Cline)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Redirhub Mcp ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Generate a Workspace API token from RedirHub’s dashboard (Settings → API Tokens), then add the server to your MCP client config with the endpoint https://api.redirhub.com/mcp/v1 and a Bearer token header. Once connected, issue natural language commands like “Create a 301 redirect from /old-blog to /blog on my domain.”
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"redirhub mcp server": {
"redirhub": {
"url": "https://api.redirhub.com/mcp/v1",
"headers": {
"Authorization": "Bearer rh_YOUR_API_TOKEN"
}
}
}
}
}
McpServers
{
"redirhub": {
"url": "https://api.redirhub.com/mcp/v1",
"headers": {
"Authorization": "Bearer rh_YOUR_API_TOKEN"
}
}
}
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, 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/this_month/last_month/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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




