URLpipe

Servidor MCP hospedado que renderiza páginas no Chrome real: Markdown, capturas de tela, metadados, erros de console e Lighthouse.

Servidor MCP hospedado

npx add-mcp 'https://urlpipe.dev/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Dê ao seu agente de IA um navegador que renderiza JavaScript

A maioria das ferramentas de fetch faz um HTTP GET simples, então um site em JavaScript retorna vazio. Esta carrega a página em um navegador real primeiro — hospedado, um token, nada para executar localmente.

Por Roger Campos · Última atualização: setembro de 2026

Resumo

O servidor MCP da URLpipe é um servidor remoto de HTTP streamable em https://urlpipe.dev/mcp.. Adicione-o ao seu cliente com um token bearer e seu agente terá 14 ferramentas: Markdown renderizado, HTML, capturas de tela que ele pode visualizar, metadados, Lighthouse, erros de console e mais — cada página carregada em Chrome real, com os mesmos créditos da API HTTP.

Plano gratuito, sem cartão de crédito. 1.000 créditos por mês.

O problema

Por que um agente precisa de um fetch com renderização

O servidor MCP de referência fetch — o que a maioria dos tutoriais instala primeiro — busca uma página com um HTTP GET simples e converte o HTML que recebe. Isso é suficiente para um blog. Em um aplicativo React, Vue ou Angular, o HTML é um contêiner vazio e uma tag de script, e o agente recebe nada enquanto acredita que leu a página.

Servidor de fetch de referênciaServidor MCP da URLpipe
Como a página é carregadaHTTP GET (httpx), sem JavaScriptChrome headless real, scripts executados
Onde executaNa sua máquina (uvx / pip / Docker)Hospedado — nada para instalar
SaídaMarkdown (Readability + markdownify), ou brutoMarkdown, HTML renderizado, captura de tela, metadados, Lighthouse, console, resumo, palavras-chave
Capturas de telaRetornadas como uma imagem que o modelo pode ver
Banners de cookies e anúnciosRemovidos com page_options
CustoGratuito, código abertoCréditos do seu plano URLpipe

O servidor de fetch é a ferramenta certa quando as páginas são estáticas e você quer tudo local e gratuito. Use este quando o agente encontrar páginas que precisam de um navegador, ou quando precisar ver uma página, não apenas lê-la. O código-fonte está em modelcontextprotocol/servers.

Configuração

Conecte seu cliente

Crie um token de organização em Acesso MCP no seu painel, depois forneça ao seu cliente a URL e o cabeçalho.

Três valores são toda a configuração: transporte HTTP streamable, URL https://urlpipe.dev/mcp, e um cabeçalho Authorization: Bearer YOUR_TOKEN. Não há fluxo OAuth nem processo local. O token não é sua chave de API do projeto — veja tokens e escopos abaixo.

Claude Code

claude mcp add --transport http urlpipe https://urlpipe.dev/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor

~/.cursor/mcp.json (ou .cursor/mcp.json em um projeto)

{
  "mcpServers": {
    "urlpipe": {
      "url": "https://urlpipe.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:URLPIPE_MCP_TOKEN}"
      }
    }
  }
}

VS Code

{
  "inputs": [
    {
      "type": "promptString",
      "id": "urlpipe-token",
      "description": "URLpipe MCP token",
      "password": true
    }
  ],
  "servers": {
    "urlpipe": {
      "type": "http",
      "url": "https://urlpipe.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${input:urlpipe-token}"
      }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "urlpipe": {
      "serverUrl": "https://urlpipe.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${env:URLPIPE_MCP_TOKEN}"
      }
    }
  }
}

Claude Desktop

O arquivo de configuração do Claude Desktop inicia servidores locais, então um servidor remoto com cabeçalho bearer passa pela ponte mcp-remote, que precisa de Node.js. O espaço do cabeçalho fica na variável de ambiente porque alguns clientes não escapam espaços em argumentos:

{
  "mcpServers": {
    "urlpipe": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://urlpipe.dev/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Qualquer outro cliente que fale HTTP streamable segue o formato genérico na documentação do MCP. Mantenha o token fora de arquivos que você commita — os exemplos acima o leem de uma variável de ambiente ou de um prompt onde o cliente suporta.

Ou instale a partir de um diretório

O servidor está listado nos diretórios MCP, que o configuram para você nos clientes que suportam, e no Registro MCP oficial como dev.urlpipe/mcp. Sua entrada no registro e a configuração para cada cliente acima são código aberto no GitHub.

Smithery Glama cursor.directory GitHub: URLpipe/mcp

Ferramentas

As 14 ferramentas

Nove são os endpoints da API, com os mesmos argumentos e as mesmas respostas. Cinco existem apenas aqui.

FerramentaO que retornaCréditos
fetch_markdownO conteúdo principal da página como Markdown1
fetch_htmlO HTML renderizado, após JavaScript1
capture_screenshotUma captura de tela de página inteira, como uma imagem que o modelo pode ver1
capture_console_errorsErros, avisos e exceções não capturadas que a página registra1
run_lighthouse_auditPontuações Lighthouse e métricas de laboratório Core Web Vitals2
extract_metadataTítulo, descrição, autor, datas, imagem, favicon, feed1
extract_keywordsPalavras-chave da página, por um modelo de IA15
summarize_pageUm resumo da página, por um modelo de IA17
scrape_urlVários dos acima em uma única visita à páginasoma de suas operações
list_projectsSeus projetos e seus ids — cada fetch nomeia um0
get_usageCréditos usados e restantes, data de redefinição, lista de preços0
get_resultO resultado de uma chamada anterior, por token0
list_requestsO que um projeto já buscou, filtrável por rótulo0
get_requestUma solicitação em detalhes: tempos, opções, entrega de webhook0

Diga ao seu agente uma vez: fetch_markdown custa 1 crédito e summarize_page custa 17 créditos. Se o agente vai ler a página por conta própria, Markdown é mais barato e melhor entrada; as ferramentas de IA são para quando o resumo ou a lista de palavras-chave é o que você está produzindo. O servidor diz o mesmo ao modelo quando ele se conecta.

Comportamento

Assíncrono por padrão, mesmo para um agente

Uma chamada de ferramenta retorna um token imediatamente e o trabalho continua em segundo plano, exatamente como a API HTTP faz. Passe sync: true quando o agente deve esperar e receber o resultado; caso contrário, ele coleta o resultado com get_result. Uma chamada assíncrona também entrega ao webhook do projeto se um estiver configurado, então um agente pode iniciar um trabalho que seu backend recebe.

Cada ferramenta de endpoint aceita project_id e url, além das opções que seu endpoint aceita — page_options, screenshot_options, max_age, residential, labels e idempotency_key para novas tentativas seguras. Resultados armazenados são reutilizados gratuitamente, então um agente que relê uma página que leu ontem não gasta nada.

Acesso

Tokens, escopos e limites

  • Tokens de organização. Um token alcança todos os projetos da organização, por isso cada fetch nomeia um project_id. Você pode restringir um token a um projeto.
  • Escopo somente leitura. Um token pode ser limitado a ler resultados passados, uso e projetos. Ele não pode buscar uma página, então não pode gastar créditos.
  • Expiração. Dê uma data de término ao token, ou exclua-o para revogá-lo imediatamente. Ele é mostrado uma vez e armazenado como hash.
  • Limites. 300 chamadas por 5 minutos por token — confortavelmente acima de uma por segundo, sustentado — e o limite de solicitações paralelas do seu plano.
  • A mesma conta. Uma chamada MCP gasta exatamente o que o endpoint correspondente gasta, da mesma cota. Fetches com falha e resultados reutilizados são gratuitos.

Limites

O que ele não faz

  • Sem navegação interativa. O agente não pode clicar, digitar, fazer login ou preencher formulários. Cada ferramenta carrega uma URL pública e relata o que encontrou.
  • Sem crawling. Ele não descobre nem segue links por conta própria; o agente decide quais URLs buscar.
  • Sem login OAuth. A autenticação é um cabeçalho bearer; clientes que só suportam conector OAuth precisam da ponte mostrada para Claude Desktop.
  • Apenas páginas públicas. Endereços privados, loopback e intranet são recusados.

Preços

Quanto custa

ChamadaCréditosGratuito (chamadas/mês)Starter (chamadas/mês)Pro (chamadas/mês)Scale (chamadas/mês)
/markdown1 crédito1.00020.00055.000175.000
/screenshot1 crédito1.00020.00055.000175.000
/meta1 crédito1.00020.00055.000175.000

Acessos de cache e solicitações com falha não custam nada. Planos pagos nunca são cortados: além da cota, créditos extras custam $1,50 por 1.000 créditos. Veja todos os planos.

Endpoints

Os endpoints nesta página

FAQ

Perguntas frequentes

Este servidor MCP renderiza JavaScript?

Sim. Toda ferramenta que lê uma página a carrega em Chrome headless e deixa seus scripts executarem primeiro, então aplicativos de página única retornam com seu conteúdo — ao contrário do servidor de fetch de referência, que faz um HTTP GET simples.

Preciso instalar algo?

Não. É um servidor remoto de HTTP streamable: forneça ao seu cliente a URL https://urlpipe.dev/mcp e um cabeçalho Authorization: Bearer. Apenas clientes que iniciam servidores locais a partir de um arquivo de configuração, como Claude Desktop, precisam da ponte mcp-remote.

Quanto custa?

Os mesmos créditos da API HTTP, da mesma cota mensal — fetch_markdown custa 1 crédito, capture_screenshot 1 crédito, extract_metadata 1 crédito. O plano gratuito também funciona com MCP.

O agente pode ver capturas de tela?

Sim. capture_screenshot retorna a imagem como um bloco de conteúdo de imagem MCP, então um modelo que aceita imagens olha para a página em vez de segurar uma string base64. Um link sem chave para a imagem retorna ao lado dela.

Posso impedir um agente de gastar créditos?

Crie o token com o escopo somente leitura. Ele pode listar projetos, verificar uso e ler resultados que já foram pagos, e não pode buscar uma página.

Por que minha chamada de ferramenta retornou um token em vez de um resultado?

Assíncrono é o padrão, como na API HTTP. Passe sync: true para esperar o resultado, ou colete depois com get_result e o token.

Conecte seu agente em dois minutos.

Plano gratuito, sem cartão. Confirme seu e-mail e sua chave de API estará ativa — você fará solicitações reais em minutos.