Desenvolvedores e agentes de IA

API pública e servidor MCP

Os dados públicos do site em formatos que agentes de IA e integrações entendem. Tudo é somente leitura, sem cadastro e sem chave de acesso.

API REST

API pública v1

Base: https://wbxservicos.com.br/api/v1. Respostas em JSON (UTF-8), com CORS liberado. Especificação em OpenAPI 3.1.

Método	Caminho	Retorna
GET	/api/v1/empresa.json	Dados da empresa, contato e horários
GET	/api/v1/produtos.json	Produtos e serviços, com links
GET	/api/v1/paginas.json	Páginas do site e links para a versão em Markdown
GET	/api/v1/saude	Health check (application/health+json)
GET	/api/v1/openapi.json	Especificação OpenAPI 3.1

Model Context Protocol

Servidor MCP

Endpoint https://wbxservicos.com.br/mcp, transporte Streamable HTTP, sem autenticação. Versões do protocolo: 2025-06-18, 2025-03-26 e 2024-11-05. Detalhes no Server Card.

Ferramentas

listar_produtos — Produtos e serviços, com descrição e links
obter_contato — Endereço, telefone, WhatsApp, e-mail, horários e formulário
listar_paginas — Páginas do site com título, descrição e slug
ler_pagina — Conteúdo de uma página em Markdown (parâmetro "pagina")
buscar — Trechos das páginas que contêm um termo (parâmetro "termo")

As páginas do site também ficam disponíveis como recursos MCP (resources/list e resources/read), em Markdown.

Configuração em um cliente MCP

{
  "mcpServers": {
    "wbx-servicos": {
      "type": "http",
      "url": "https://wbxservicos.com.br/mcp"
    }
  }
}

Teste rápido

curl -s https://wbxservicos.com.br/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buscar","arguments":{"termo":"backup"}}}'

Conteúdo

Páginas em Markdown

Qualquer página do site responde em Markdown quando a requisição traz Accept: text/markdown. O cabeçalho x-markdown-tokens informa o tamanho estimado. Também é possível abrir direto, por exemplo /servidores.md.

Descoberta

Arquivos para agentes

/llms.txt — Resumo da empresa e dos produtos para IAs
/.well-known/api-catalog — Catálogo de APIs (RFC 9727)
/.well-known/mcp/server-card.json — MCP Server Card
/.well-known/ai-catalog.json — Catálogo ARD
/.well-known/agent-skills/index.json — Índice de Agent Skills
/sitemap.xml — Mapa do site

Regras de uso

O que a API não faz

Não envia pedidos de proposta: o formulário do site exige o consentimento da própria pessoa (LGPD). Agentes devem indicar o formulário ou o WhatsApp.
Não informa preços: cada projeto recebe proposta sob medida.
Não dá acesso a dados de clientes nem a sistemas internos.

Dúvidas técnicas: suporte@wbxservicos.com.br.