Pular para o conteúdo principal

Deveserisso para Desenvolvedores — Servidor MCP

O Deveserisso expõe um servidor MCP (Model Context Protocol) público, pra agentes de IA consultarem o catálogo de resenhas do site de forma estruturada, sem precisar fazer scraping de HTML.

Endpoint

https://deveserisso.com.br/wp-json/webmcp/v1/

Também anunciado via header Link: rel="mcp" em toda resposta HTML do site, e no llms.txt.

Ferramentas disponíveis

  • search — busca posts por termo (parâmetro q)
  • get_post — retorna um post específico pelo slug
  • categories — lista as categorias do site
  • assinar-newsletter — inscreve um e-mail na newsletter (POST)

Especificação da API

Spec completa em OpenAPI 3.0 (/openapi.json). Catálogo de todas as APIs do site (WebMCP + WordPress REST API nativa) em /.well-known/api-catalog (RFC 9727).

Markdown para qualquer post/página

Fora do MCP, qualquer post ou página individual do Deveserisso também está disponível em Markdown puro: adicione .md ao final da URL (ex: /algum-post.md). Detalhes completos no llms.txt.

Versionamento

A API é versionada na própria URL (/v1/). Mudanças que quebrem compatibilidade sairão como uma nova versão (/v2/); a v1 permanece funcionando durante o período de transição — sem prazo de desligamento definido até o momento.