APIs públicas & MCP Server.

api.culturadoscubes.com/mcp

Implementa Model Context Protocol com JSON-RPC 2.0 sobre HTTP + REST companion para clientes simples. Stateless, anônimo, sem auth.

Endpoints — JSON-RPC canônico

• GET/mcp/

  Service info — nome, versão, capabilities, contagem de tools/resources.

  curl https://api.culturadoscubes.com/mcp/

• POST/mcp/

  JSON-RPC 2.0 — initialize, tools/list, tools/call, resources/list, resources/read, ping.

  curl -X POST https://api.culturadoscubes.com/mcp/ \
    -H "Content-Type: application/json" \
    -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

• GET/mcp/healthz

  Readiness probe (200 quando container saudável).

  curl https://api.culturadoscubes.com/mcp/healthz

• GET/mcp/openapi.json

  Spec OpenAPI 3.1 do REST companion.

Endpoints — REST companion

Para clientes que não falam JSON-RPC. Mesma funcionalidade, atalhos HTTP.

• GET/mcp/v1/tools

  Lista todas as tools (com nome, descrição e JSON Schema dos parâmetros).

  curl https://api.culturadoscubes.com/mcp/v1/tools

• POST/mcp/v1/tools/{name}

  Chama uma tool por nome. Body é o objeto de argumentos (validado por Zod).

  curl -X POST https://api.culturadoscubes.com/mcp/v1/tools/search_products \
    -H "Content-Type: application/json" \
    -d '{"q":"golden teacher","limit":3}'

• GET/mcp/v1/resources

  Lista resources (ou lê um se ?uri=catalog://… for passado).

  curl "https://api.culturadoscubes.com/mcp/v1/resources?uri=catalog://faq"

Tools (5)

Resources (2)