O URL MCP respondido. O gerador de docs ainda queria um snapshot.

Eu executo o servidor público SameDayDesk MCP em https://agents.samedaydesk.com/mcp. Um agente pode inicializar e chamar tools/list lá. A sessão desaparece quando o cliente se desconecta, não fornece uma tabela de argumentos ao leitor e não deixa um llms.txt que outro modelo possa buscar mais tarde.

Eu queria um site estático que um agente pudesse ler sem abrir JSON-RPC: nomes de ferramentas, campos obrigatórios, chamadas de exemplo e um arquivo que ele possa indexar. Eu usei Sourcey para isso. Em 2 de setembro de 2026, sua página de código aberto dizia que transforma OpenAPI, MCP, Doxygen, godoc, rustdoc e Markdown em um único site HTML estático que você possui, com guias, changelog, roadmap e llms.txt do mesmo build, licenciado AGPL-3.0.

Eu clonei github.com/sourcey/sourcey no commit 6a8e38da92a64759851937a055acec4e7c3db413. O package.json naquele commit é a versão 3.6.5, licença AGPL-3.0-only, Node 20 ou posterior. O changelog data 3.6.5 a 12 de julho de 2026. Eu construí a CLI a partir daquela árvore. Eu não mudei o Sourcey e não mudei o servidor ao vivo.

A URL MCP ao vivo não é uma especificação

GET https://agents.samedaydesk.com/mcp retorna um pequeno cartão JSON: nome x402-data-gateway, transporte streamable-http, método POST, toolCount 22, além de ponteiros para OpenAPI e evidências de compra. O cartão é útil para descoberta, mas o Sourcey precisa de um snapshot MCP.

Os docs do MCP do Sourcey, lidos no mesmo dia, dizem que as abas MCP requerem Sourcey 3.4.0 ou posterior, e que mcp() aponta para um arquivo mcp.json relativo a sourcey.config.ts. Os docs chamam esse arquivo de um snapshot estático das capacidades de um servidor MCP.

Eu ainda apontei mcp("https://agents.samedaydesk.com/mcp") para a URL ao vivo. O Sourcey começou a construção do site, então falhou:

Erro: ENOENT: nenhum arquivo ou diretório encontrado, abrir 'https://agents.samedaydesk.com/mcp'

O mcp-parser's parse() abre um caminho. Ele não fala JSON-RPC. O adaptador Sourcey aceitará uma string de URL. O parser não buscará uma sessão MCP ao vivo.

Snapshot do servidor em execução

O guia de snapshot diz para você se conectar com o mcp-parser e escrever o arquivo. Para HTTP transmitível, o comando documentado é:

mcp-parser snapshot --http http://localhost:3000/mcp -o mcp.json

Eu executei isso contra o endpoint público com mcp-parser 0.4.1:

npx mcp-parser@0.4.1 snapshot --http https://agents.samedaydesk.com/mcp -o mcp.json

Ele se conectou e escreveu o snapshot. Servidor: x402-data-gateway v1.23.40. Ferramentas: 22. Recursos: 0. Prompts: 0. Isso correspondeu a um tools/list separado via HTTP transmitível, que também retornou 22 ferramentas. Os nomes incluíam extract, read, enrich, wallet_enrich, scan e as ferramentas de pré-verificação de pagamento. resources/list e prompts/list retornaram JSON-RPC -32601 método não encontrado, então os zeros eram reais, não um padrão vazio que eu inventei.

mcp-parser validate ./mcp.json disse válido com um aviso: descrição do servidor ausente.

O snapshot registrou o transporte streamable-http e a URL https://agents.samedaydesk.com/mcp. Ele também armazenou _meta.x402 em cada ferramenta, cada uma com paymentRequired: true. O snapshot capturou os termos de pagamento descritos pelo servidor como metadados do catálogo. Eu não executei uma chamada de ferramenta paga tools/call.

Construir o site estático

A configuração era uma aba:

import { defineConfig, mcp } from "sourcey";

export default defineConfig({
  name: "SameDayDesk MCP",
  navigation: {
    tabs: [
      {
        tab: "Referência MCP",
        slug: "",
        source: mcp("./mcp.json"),
      },
    ],
  },
});

sourcey build da CLI 3.6.5 escreveu uma página HTML. O diretório de saída também continha llms.txt, llms-full.txt, search-index.json, sitemap.xml, sourcey.css, sourcey.js e uma imagem OG.

llms.txt listou x402-data-gateway como 22 operações documentadas, então cada ferramenta com sua descrição. O índice de busca indexou os 22 títulos das ferramentas.

A página MCP renderizou um cartão de conexão:

{
  "mcpServers": {
    "x402-data-gateway": {
      "url": "https://agents.samedaydesk.com/mcp"
    }
  }
}

Ele rotulou o protocolo MCP 2025-11-25 e o transporte streamable-http. Cada ferramenta tinha uma pílula TOOL, a tabela de argumentos do inputSchema, uma seção de Retornos e amostras em JSON-RPC, TypeScript e Python. O exemplo gerado de extract foi: