---
title: "API pública e servidor MCP | WBX Serviços"
description: "Dados públicos da WBX Serviços para agentes de IA e integrações: API REST somente leitura, servidor MCP, páginas em Markdown e llms.txt."
url: https://wbxservicos.com.br/desenvolvedores
---

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](https://wbxservicos.com.br/api/v1/openapi.json).

Método

Caminho

Retorna

GET

[/api/v1/empresa.json](https://wbxservicos.com.br/api/v1/empresa.json)

Dados da empresa, contato e horários

GET

[/api/v1/produtos.json](https://wbxservicos.com.br/api/v1/produtos.json)

Produtos e serviços, com links

GET

[/api/v1/paginas.json](https://wbxservicos.com.br/api/v1/paginas.json)

Páginas do site e links para a versão em Markdown

GET

[/api/v1/saude](https://wbxservicos.com.br/api/v1/saude)

Health check (application/health+json)

GET

[/api/v1/openapi.json](https://wbxservicos.com.br/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](https://wbxservicos.com.br/.well-known/mcp/server-card.json).

### 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`](https://wbxservicos.com.br/servidores.md).

Descoberta

## Arquivos para agentes

-   [/llms.txt](https://wbxservicos.com.br/llms.txt) — Resumo da empresa e dos produtos para IAs
-   [/.well-known/api-catalog](https://wbxservicos.com.br/.well-known/api-catalog) — Catálogo de APIs (RFC 9727)
-   [/.well-known/mcp/server-card.json](https://wbxservicos.com.br/.well-known/mcp/server-card.json) — MCP Server Card
-   [/.well-known/ai-catalog.json](https://wbxservicos.com.br/.well-known/ai-catalog.json) — Catálogo ARD
-   [/.well-known/agent-skills/index.json](https://wbxservicos.com.br/.well-known/agent-skills/index.json) — Índice de Agent Skills
-   [/sitemap.xml](https://wbxservicos.com.br/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](https://wbxservicos.com.br/contato#contato-form) ou o [WhatsApp](https://wa.me/5541992370987).
-   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](mailto:suporte@wbxservicos.com.br).

---

WBX Serviços · Rua Marechal Deodoro, 431, 7º andar, Curitiba – PR · (41) 3514-5945 · WhatsApp (41) 99237-0987 (https://wa.me/5541992370987) · suporte@wbxservicos.com.br
Solicitar proposta: https://wbxservicos.com.br/contato
