RedirHub MCP API

Servidor MCP RedirHub

Controle cada link pelo seu assistente de IA. Crie links de marca, QR codes dinâmicos, redirecionamentos de domínio e migrações completas de sites; depois gerencie, audite e meça tudo por um protocolo padronizado, compatível com Claude, Cursor e qualquer cliente MCP.

A RedirHub é uma infraestrutura de redirecionamento. Este servidor MCP dá aos seus agentes de IA acesso direto a essa infraestrutura: crie e gerencie links, conecte domínios, convide membros da equipe e consulte análises, tudo sem abrir um painel.

Recursos

• Um modelo para cada link: links de marca, QR codes dinâmicos, redirecionamentos de domínio e migrações de site são criados por intenção e gerenciados como um único tipo de objeto, como no painel.
• QR codes que seu agente pode entregar: create-qr-code e get-qr-code retornam a própria imagem do QR code, desenhada exatamente como o painel desenha.
• Alterações em massa seguras: as ferramentas em massa fazem uma prévia por padrão e só aplicam alterações com um token de confirmação dessa prévia.
• Mesmas regras do painel: links criados ou atualizados aqui passam pela mesma validação, recursos do plano e limites do painel e da API REST.
• Análises e registros: consulte estatísticas de cliques, registros de acesso brutos e o histórico de alterações de cada link.
• Colaboração em equipe: espaços de trabalho com vários membros e controle de acesso baseado em funções.
• Protocolo MCP: funciona com Claude, Cursor, Cline e qualquer cliente MCP que chame ferramentas.

Endpoint

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

Autenticação

Gere um token de API do espaço de trabalho em dash.redirhub.com (Configurações → Tokens de API) e passe-o como um token Bearer:

Authorization: Bearer ***

Disponível em todos os planos, inclusive no Gratuito. Alterar links e domínios exige a função editor; configurações do espaço de trabalho e membros exigem a função gerente.

Informações do servidor

• Nome: Redirect Infra Public API
• Versão: 1.1.0
• Transporte: HTTP Streamable (JSON-RPC 2.0)

Modelo de dados

Os usuários pertencem a espaços de trabalho (organizações). Um espaço de trabalho tem domínios personalizados (hosts) e links.

Os links são criados a partir de quatro intenções, mas gerenciados como um único tipo de objeto:

Intenção	Ferramenta	O que é
Link de marca	create-branded-link	Um URL curto no seu próprio domínio de links curtos, ex.: go.acme.co/spring
QR code dinâmico	create-qr-code	Um link de marca para impressão; o destino pode mudar após a impressão
Redirecionamento de domínio	create-redirect	Um domínio, subdomínio ou caminho enviado a um destino, ex.: old.acme.co → acme.com
Migração de site	bulk-import com handler: "migration"	Muitos URLs antigos mapeados para novos de uma só vez

Cada link tem um id (ex.: link_7bXmR4) que as ferramentas get-link, update-link, delete-link, get-qr-code e get-link-history recebem. Os domínios são endereçados pelo nome do host e os membros, pelo id (ex.: user_zwbJjgb8).

Ferramentas

Links: leitura

Ferramenta	O que faz
list-links	Lista links, do mais novo ao mais antigo. Filtros: ids, handler (redirect, migration, short-url, qr), host, search, tags, status (active/paused), dns_correct, created_after, created_before. Pagine com per_page (máx. 100) e cursor.
get-link	Um link por id: destinos, tipo de redirecionamento, plugins, parâmetros UTM, estilo do QR e tags.
count-links	Contagens para os mesmos filtros: total, paused, dns_issue e no_clicks (sem cliques nas últimas quatro semanas).
get-link-history	As alterações de um link, da mais nova para a mais antiga: o que mudou (destino, UTM, tipo, status), quem mudou e como. Exige o recurso de trilha de auditoria (planos Pro e superiores); sem ele, apenas a contagem é retornada.
get-qr-code	O QR code de um link como imagem PNG, no estilo salvo, com o logotipo do espaço de trabalho quando o estilo pedir.
get-link-options	Os valores aceitos: tipos de redirecionamento, estratégias de roteamento de destino e plugins, com o recurso do plano que cada um exige.

Links: criação

Ferramenta	O que faz
create-branded-link	host (um domínio de links curtos) e destination obrigatórios; opcionais: alias (gerado quando omitido), title, description, utm, tags, status.
create-qr-code	Mesmos argumentos de create-branded-link. Retorna o link e a imagem do QR code no estilo padrão; o estilo pode ser personalizado no painel.
create-redirect	url (a origem: domínio, subdomínio ou caminho) obrigatório; opcionais: destination, destinations + destination_routing, type (301, 302, 307, 308, frame, txt), forward_path, forward_query, plugins, utm, title, description, tags, status.

Use list-hosts com short_links_enabled: true para encontrar os domínios que links de marca e QR codes podem usar.

Links: gerenciamento

Ferramenta	O que faz
update-link	Atualiza um link por id. Apenas os campos informados mudam; o URL de origem e o tipo de link nunca mudam.
delete-link	Exclui um link por id, com o histórico de alterações. Irreversível.
bulk-update-links	Aplica as mesmas alterações a vários links. Selecione-os com os filtros list-links (exceto tags e status, que ele define) ou use all_links: true para todos os links.
bulk-delete-links	Exclui links por source_urls[], ex.: ["acme.co/old-page"].
bulk-import	Importa até ~5.000 links por chamada de rows[]. Cada linha: {url, destination?, handler?, type?, title?, description?, tags?, destinations?, destination_routing?, utm?}; handler é redirect (padrão), migration ou short-url. mode é create (padrão; URLs de origem existentes são ignorados) ou upsert (eles são substituídos). Conta para o limite de links do plano.

⚠️ Segurança de operações em massa

bulk-update-links, bulk-delete-links e bulk-import apenas fazem a prévia, a menos que sejam chamadas com dry_run: false:

1. Chame sem dry_run. A prévia retorna a contagem afetada, uma amostra dos URLs afetados e, para alterações e exclusões, um confirmation_token.
2. Mostre a contagem ao usuário.
3. Somente após a confirmação do usuário, chame novamente com os mesmos argumentos, dry_run: false e o confirmation_token.

O servidor impõe isso: bulk-update-links, bulk-delete-links e bulk-import no modo upsert se recusam a aplicar alterações sem um token emitido exatamente para os mesmos argumentos, pelo mesmo usuário, no mesmo espaço de trabalho, na última uma a duas horas.

Domínios

Ferramenta	O que faz
list-hosts	Lista domínios personalizados com o status de DNS, HTTPS e links curtos. Filtros: search, short_links_enabled, shared (também lista os domínios compartilhados da plataforma).
get-host	Um domínio por nome de host, com os registros DNS necessários.
connect-host	Conecta um domínio raiz (acme.com), subdomínio (go.acme.com) ou curinga (*.acme.com); retorna os registros DNS a adicionar. Opcionais: short_links_enabled, https_requested.
update-host	Ativa ou desativa HTTPS e links curtos em um domínio.
refresh-host	Verifica novamente o DNS de um domínio agora.

Espaço de trabalho e membros

Ferramenta	O que faz
get-workspace	O espaço de trabalho atual: plano, limites, uso e configurações.
update-workspace	Atualiza uma configuração: name, country, email, billing_extra, email_summary, email_host_status, email_manager.
list-members	Membros com a função deles (viewer, editor, manager).
add-member	Convida pessoas por e-mail: invites: [{email, role?}].
update-member	Altera a função de um membro.
remove-member	Remove um membro.

Conta

Ferramenta	O que faz
get-account	O perfil do usuário conectado.
update-account	Atualiza uma configuração de perfil: name, language, currency, timezone, current_workspace, login_workspace, country, phone, im.

📊 Estatísticas

Ferramenta	O que faz
get-stats	Análises de cliques. Defina file/files para estatísticas por link (totais, tendência diária, detalhamentos por país, cidade, navegador, dispositivo, referenciador, protocolo); omita-os para estatísticas do espaço de trabalho (total de cliques, visitantes únicos, contagens de links ativos/totais, detalhamentos por link e tipo). time_range é 7d, 30d, 90d, 180d, this_month ou last_month, ou use date_from + date_to. Os cliques alcançam 90 dias (180 em planos com mais histórico de análises); os detalhamentos cobrem os últimos 14 dias (Enterprise: sem limite).
get-access-logs	Visitas brutas (hora, IP, agente do usuário, país, navegador, referenciador, ...). Filtros: file, date_from/date_to, country, handler, browser, device, referrer, search (IP ou agente do usuário), bot_free. Cobre os últimos 14 dias (Enterprise: sem limite). Paginação por cursor.

QR codes

create-qr-code e get-qr-code retornam o código como PNG de 512 px, desenhado exatamente como o painel desenha: mesmos módulos, cores, margem, logotipo do espaço de trabalho e link legível abaixo. O código codifica o link com ?utm_source=qr, então as leituras são contadas separadamente dos cliques.

Para arquivos de impressão, a API REST serve o mesmo código como SVG ou PNG (512, 1024 ou 2048 px de largura):

GET https://api.redirhub.com/v1/links/{id}/qr              # SVG
GET https://api.redirhub.com/v1/links/{id}/qr?format=png&width=2048

Recursos

Clientes que anexam recursos MCP também podem ler os mesmos dados como recursos (anexe os parâmetros de consulta como ?key=value): redirects://list, redirects://link_{id}, redirects://count, links://list, links://link_{id}, hosts://list, hosts://{hostname}, workspace://current, members://list, members://{user_id}, account://me, plugins://catalog e record-types://catalog.

A maioria dos clientes só permite que o modelo chame ferramentas, então prefira as ferramentas acima; elas cobrem tudo o que os recursos fazem.

Ferramentas renomeadas

A versão 1.1 removeu o sufixo -tool e nomeou as ferramentas de registro pelos links. Os nomes antigos continuam funcionando, então as configurações existentes não quebram, mas novos prompts e integrações devem usar os novos:

Nome antigo	Nome novo
create-redirect-tool	create-redirect
create-link-tool	create-branded-link
update-record-tool	update-link
delete-record-tool	delete-link
bulk-update-records-tool	bulk-update-links
bulk-delete-records-tool	bulk-delete-links
bulk-import-tool	bulk-import
connect-host-tool, update-host-tool, refresh-host-tool	connect-host, update-host, refresh-host
add-member-tool, update-member-tool, remove-member-tool	add-member, update-member, remove-member
update-workspace-tool, update-account-tool	update-workspace, update-account
get-stats-tool, get-access-logs-tool	get-stats, get-access-logs

Outras mudanças na 1.1:

• As ferramentas de criação retornam o link. create-redirect costumava envolvê-lo em {created, record}.
• As ferramentas em massa fazem a prévia por padrão. Elas costumavam aplicar alterações, a menos que fosse dito o contrário.
• bulk-update-links exige um filtro ou all_links: true. Ela costumava alterar todos os registros do espaço de trabalho.

Início rápido

1. Obtenha seu token de API

Cadastre-se em redirhub.com e crie um token de API do espaço de trabalho em dash.redirhub.com Configurações → Tokens de API.

2. Configure seu cliente MCP

Adicione à configuração do seu cliente; o endpoint aceita o transporte HTTP MCP padrão:

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

Funciona com Claude Desktop, Cursor e qualquer cliente HTTP compatível com MCP. Para testar a partir do terminal:

npx @modelcontextprotocol/inspector --transport http --server-url https://mcp.redirhub.com/mcp/v1

3. Use

Depois de conectado, diga ao seu agente de IA o que você precisa:

"Crie um QR code para o nosso menu em go.acme.co que aponte para acme.com/menu, e mostre para mim."

"Redirecione old.acme.co para acme.com com um 301, mantendo o caminho."

"Migre estas 500 URLs do nosso site antigo para o novo."

"Quantos links em go.acme.co não tiveram cliques nas últimas quatro semanas? Pause todos os links nesse domínio."

"Quem mudou o destino de go.acme.co/spring, e quando?"

Documentação

• Referência da API: documentação completa da API RedirHub
• dash.redirhub.com: painel web
• Especificação MCP: documentação do protocolo

---

Construído pela RedirHub: infraestrutura de redirecionamento para equipes que não podem se dar ao luxo de ter links quebrados.