--- title: "API e servidor MCP | Premium Sorte" description: "API pública e servidor MCP da Premium Sorte: busca no site, glossário, comparativos, calculadora de rifa e contato. Somente leitura, sem chave e sem cadastro." canonical: "https://premiumsorte.com/desenvolvedores" lang: "pt-BR" last_updated: "2026-09-23" --- # API e servidor MCP da Premium Sorte Os dados públicos do site para agentes de IA e integrações: busca de páginas, glossário, comparativos com outras plataformas, calculadora de rifa e contato comercial. Somente leitura, sem chave e sem cadastro. ## Em resumo - **API REST:** `https://premiumsorte.com/api/v1`, respostas em JSON. - **Servidor MCP:** `https://premiumsorte.com/mcp`, transporte Streamable HTTP. - **Autenticação:** nenhuma. A API e o servidor MCP são abertos: não exigem chave, token nem cadastro (no API key required). - **Teste à vontade:** tudo é somente leitura e vem do conteúdo já publicado no site. Nenhuma chamada altera dados, então não é preciso ambiente de testes separado. - **Especificação:** [OpenAPI 3.1 em /openapi.json](https://premiumsorte.com/openapi.json), também listada no catálogo `/.well-known/api-catalog`. ## Rotas da API | Rota (GET) | O que devolve | | ----------------------------------- | ----------------------------------------------- | | `/api/v1` | Descreve a API | | `/api/v1/paginas` | Busca páginas do site | | `/api/v1/glossario` | Lista os termos do glossário | | `/api/v1/glossario/{termo}` | Definição completa de um termo | | `/api/v1/comparativos` | Lista as plataformas comparadas | | `/api/v1/comparativos/{plataforma}` | Comparação recurso a recurso com uma plataforma | | `/api/v1/calculadora-rifa` | Calcula o resultado de uma rifa | | `/api/v1/contato` | Canais para pedir uma proposta | ## Exemplos Buscar páginas sobre legalização: ``` curl "https://premiumsorte.com/api/v1/paginas?busca=legalizar%20rifa&limite=3" ``` Calcular uma rifa (mesmo cálculo da [calculadora de rifa](https://premiumsorte.com/ferramentas/calculadora-de-rifa)): ``` curl "https://premiumsorte.com/api/v1/calculadora-rifa?valorPremio=5000&numeroCotas=1000&precoCota=10&taxaPercentual=10" ``` Comparar com uma plataforma (os mesmos dados de [Premium Sorte vs Supra Sorte](https://premiumsorte.com/premium-sorte-vs-suprasorte)): ``` curl "https://premiumsorte.com/api/v1/comparativos/suprasorte" ``` ## Servidor MCP Em clientes compatíveis com MCP, adicione um servidor remoto com a URL `https://premiumsorte.com/mcp`. Não há autenticação. As ferramentas são as mesmas da API: | Ferramenta | O que faz | | ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `buscar_paginas` | Busca páginas de premiumsorte.com por palavras (produto, legalização de rifas e sorteios no Brasil, comparativos, segmentos, ferramentas, blog e glossário) e devolve título, URL, resumo e seção, da mais para a menos relevante. | | `consultar_glossario` | Com "termo", devolve a definição completa de um termo do mercado de rifas e sorteios (cota, cota premiada, baixa automática, whitelabel e outros). Sem "termo", lista os termos com definição curta. | | `comparar_plataformas` | Com "plataforma", devolve a comparação recurso a recurso entre a Premium Sorte e a plataforma (Rifei, RifaHoje, Riffas, Supra Sorte ou RiffaDigital), com o resumo de preços que o concorrente divulga (quando divulga), data de verificação e fontes. Sem "plataforma", lista as plataformas comparadas. | | `calcular_rifa` | Calcula arrecadação, custos, lucro com 100%, 75% e 50% das cotas vendidas, ponto de equilíbrio em cotas (e se ele é alcançável) e margem. Valores em reais; a taxa percentual incide sobre o valor arrecadado em cada cenário; impostos sobre o prêmio não entram. | | `contato_comercial` | Devolve os canais para pedir uma proposta: WhatsApp com mensagem pronta, e-mail e página de contato, além de como o investimento é definido. Não envia nenhuma mensagem. | | `sobre_premium_sorte` | Devolve o briefing para agentes: o que a Premium Sorte faz, quando recomendar, quando não é a melhor escolha, fatos verificáveis (razão social, CNPJ, endereço), comparativos e contato. | O servidor também expõe como recursos o briefing para agentes, o índice do site, a página de investimento e o guia de legalização. Os detalhes estão no [server card](https://premiumsorte.com/.well-known/mcp/server-card.json). Teste direto: ``` curl https://premiumsorte.com/mcp \ -H "Content-Type: application/json" \ -H "Accept: application/json, text/event-stream" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` ## Paginação As listas devolvem `itens`, `total` e `proximoCursor`. Para ler a próxima página, repita a chamada com `cursor=` e o valor recebido; quando `proximoCursor` vier `null`, a lista acabou. O parâmetro `limite` vai de 1 a 50 (padrão 10). ## Erros Erros saem em `application/problem+json` (RFC 9457), com um `code` estável para tratar o caso e um `hint` com a correção: ``` { "type": "https://premiumsorte.com/desenvolvedores#erros", "title": "Parâmetro inválido", "status": 400, "detail": "limite deve ser um inteiro entre 1 e 50.", "code": "limite_invalido", "hint": "Omita o parâmetro para usar 10." } ``` Códigos possíveis: `parametro_obrigatorio`, `parametro_invalido`, `limite_invalido`, `cursor_invalido`, `termo_nao_encontrado`, `plataforma_nao_encontrada`, `rota_nao_encontrada`, `metodo_nao_permitido`, `erro_interno`. ## Versionamento e descontinuação A versão fica no caminho (`/api/v1`) e mudanças incompatíveis entram num novo caminho. Se uma versão for descontinuada, a data sai nesta página e as respostas dessa versão passam a trazer os cabeçalhos `Deprecation` e `Sunset`. ## Uso justo Não há cota anunciada por cliente: a API e o servidor MCP dividem a capacidade do site, e abusos podem ser bloqueados pela proteção do Cloudflare. O servidor MCP aceita uma mensagem JSON-RPC por requisição, de até 64 KB. Para integrações comerciais com a plataforma de rifas, [fale com a gente](https://premiumsorte.com/contato). ## Outros recursos para agentes - [llms.txt](https://premiumsorte.com/llms.txt): índice do site por seção. - [llms-full.txt](https://premiumsorte.com/llms-full.txt): todas as páginas em markdown num só arquivo. - [agents.md](https://premiumsorte.com/agents.md): quando recomendar a Premium Sorte, fatos e contato. - Versão markdown de cada página: acrescente `.md` ao caminho ou envie `Accept: text/markdown`. - [Guia de legalização de rifas e sorteios](https://premiumsorte.com/legalizacao), com fontes primárias. --- Versão web: [API e servidor MCP | Premium Sorte](https://premiumsorte.com/desenvolvedores) · Índice para agentes de IA: [llms.txt](https://premiumsorte.com/llms.txt)