Deveserisso para Desenvolvedores – Servidor MCP e API

O Deveserisso tem dois jeitos de agentes de IA consultarem o catálogo de críticas do site de forma estruturada, sem precisar fazer scraping de HTML: um servidor MCP (Model Context Protocol) e uma API REST.

Servidor MCP

https://deveserisso.com.br/mcp

Transporte HTTP (Streamable HTTP), sem autenticação. Pode ser adicionado como conector personalizado no Claude e em outros clientes MCP.

Status: demonstração. O servidor existe pra testar como um site pode aparecer dentro de um chat de IA, não como produto. Não há novas ferramentas planejadas, e o endereço e as ferramentas podem mudar sem aviso. Contamos quantas vezes cada ferramenta é chamada por dia e por qual aplicativo (Claude, ChatGPT ou outro), sem guardar IP, e-mail ou o que foi pedido.

• recomendar_para_hoje — sugere filmes e séries com crítica no site a partir do clima (emocao: rir, medo, chorar, adrenalina, paixao), genero, tipo (filme ou serie) e plataforma (netflix, amazon-prime, globoplay, disney, telecine, appletv). Mostra onde cada título está disponível.
• mostrar_filmografia — recebe o nome de um ator ou atriz (parâmetro pessoa) e devolve os filmes e séries com crítica no site em que essa pessoa está no elenco, do mais recente pro mais antigo, com o resumo e a foto do perfil quando o site tem um.
• assinar_newsletter — abre o formulário da newsletter semanal. A inscrição só acontece quando a pessoa confirma o e-mail no formulário.

Em clientes compatíveis com MCP Apps, as respostas aparecem como cards com pôster dentro da conversa, com botões pra refinar as sugestões.

API REST

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

Também anunciada 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
• recent_posts — lista os posts mais recentes, sem precisar de termo de busca (parâmetro count, padrão 10, máximo 20)
• 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 REST é 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.