RedirHub MCP API

★ 1

from redirhub

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.

🔥🔥🔥✓ VerifiedFreeQuick setup

#automation #analytics #marketing

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:

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

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.

Quick Start

1. Get Your API Token

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