Para desenvolvedores

O que um cliente precisa saber sobre o servidor e como chamá-lo sem um assistente no meio.

O protocolo como o servimos

  • Streamable HTTP em https://api.publicwww.com/mcp: uma mensagem JSON-RPC por POST (lotes também são aceitos), e as respostas são application/json simples. Sem server-sent events, sem sessões: cada requisição leva o seu token. GET retorna 405.
  • As duas gerações do protocolo são servidas na mesma URL: as revisões com o handshake initialize (de 2024-11-05 a 2025-11-25) e a 2026-07-28, com server/discover, em que a versão e as capacidades do cliente vão em params._meta de cada requisição, e Mcp-Method / Mcp-Name precisam corresponder ao corpo.
  • Sem token, ou com um token excluído, qualquer requisição recebe 401, com um cabeçalho WWW-Authenticate que indica os metadados do recurso protegido (RFC 9728), a partir dos quais um cliente OAuth encontra o servidor de autorização. O fluxo está em OAuth 2.1 para aplicativos.
  • Ferramentas: search e account, descritas em Ferramentas. Não há resources nem prompts, e a lista não muda entre as chamadas.
  • Sem token, o server card descreve o servidor: nome, endereço, versões do protocolo e links. Ele está listado em https://publicwww.com/.well-known/ai-catalog.json. A lista de ferramentas não faz parte do card; ela vem de tools/list quando o cliente já tem um token.

Como chamar com curl

O servidor não guarda estado entre as chamadas, então uma ferramenta pode ser chamada diretamente, sem o handshake: 

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
          "params":{"name":"search","arguments":{"query":"\"angular.min.js\"","rows":3}}}'

A lista de ferramentas com os schemas de entrada: 

curl https://api.publicwww.com/mcp \
     -H "Authorization: Bearer $KEY" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Essas chamadas e uma verificação de conta, em um único script: mcp-curl.sh.

Para um script que só precisa dos resultados da busca, a API REST é o caminho mais simples: a mesma busca e o mesmo token, com CSV, NDJSON e os outros formatos.

A seguir Idiomas