Dados abertos e IA

Pergunte à sua IA, com dado oficial

Conecte o Claude, o Cursor, o VS Code ou outro assistente ao Observatório BR. Ele consulta os indicadores da economia brasileira direto das nossas bases e responde citando a fonte, o período e o link do painel. É gratuito, não precisa de cadastro e é somente leitura.

URL do servidorhttps://observatoriobr.com.br/api/mcp

MCP (Model Context Protocol) é o padrão aberto que os assistentes usam para consultar fontes externas. Referência técnica →

01 — Conectar

Em menos de um minuto

Claude (claude.ai e Desktop)

Abra Configurações → Conectores.
Clique em “Adicionar conector personalizado” e cole a URL do servidor.
Na conversa, ative o Observatório BR no menu de ferramentas.

Abrir conectores do Claude

Claude Code

Rode no terminal:

Comando

claude mcp add --transport http observatorio-br https://observatoriobr.com.br/api/mcp

Cursor

Instale com um clique ou acrescente o bloco ao ~/.cursor/mcp.json.

Instalar no Cursor

mcp.json

{
  "mcpServers": {
    "observatorio-br": {
      "type": "http",
      "url": "https://observatoriobr.com.br/api/mcp"
    }
  }
}

VS Code (Copilot)

Instale com um clique ou rode o comando no terminal.

Instalar no VS Code

Comando

code --add-mcp '{"name":"observatorio-br","type":"http","url":"https://observatoriobr.com.br/api/mcp"}'

Outros clientes

Qualquer cliente que aceite servidor remoto (Streamable HTTP) usa a mesma URL. Nos que leem JSON:

Configuração

{
  "mcpServers": {
    "observatorio-br": {
      "type": "http",
      "url": "https://observatoriobr.com.br/api/mcp"
    }
  }
}

02 — Perguntar

O que dá para perguntar

Escreva como falaria com alguém. O assistente escolhe as ferramentas e cita a origem de cada número.

“A inflação de serviços está acima ou abaixo do que o Focus espera para este ano?”
“O termômetro de recessão mudou desde o mês passado? Quais sinais pesaram?”
“Compare o desemprego e a renda média real nos últimos cinco anos.”
“Qual é o perfil econômico de Pernambuco, e quais números são estimados?”
“O que o boletim semanal mais recente diz sobre juros e câmbio?”

03 — Confiar

Por que o número vem certo

Fonte em cada número

Toda resposta das ferramentas traz a fonte oficial (IBGE, Banco Central, Tesouro, Ipeadata, Banco Mundial), o período e o link do painel.

Avisa quando falta dado

Série vazia ou defasada volta marcada, e o assistente é instruído a dizer isso antes de citar qualquer valor, em vez de completar de memória.

Somente leitura

Nenhuma ferramenta altera dados ou dispara coleta. Boletins e pílulas chegam ao assistente como texto, nunca como instrução.

Observado × estimado

Nos territórios, cada número diz se é observado, estimado ou se não há dado. Resultados de modelos são estimativas, e vêm rotulados assim.

04 — Conteúdo

O que o servidor oferece

Indicadores: Catálogo, séries históricas, último valor, comparação entre indicadores e o conteúdo completo de cada painel.
Conjuntura: Termômetro de recessão, os sete pilares, panorama e o calendário das próximas divulgações.
Território: Brasil, regiões e UFs, com a natureza de cada número.
Conteúdo: Busca, boletins, pílulas, glossário, metodologia e crises econômicas.

A lista completa das ferramentas, os prompts prontos e os limites de cada resposta estão na documentação técnica.

Limites e chave opcional

Sem chave, cada IP faz até 30 chamadas por minuto, e o tráfego anônimo somado tem um teto comum. Para usar numa pesquisa ou num produto, peça uma chave gratuita pelo formulário de contato, dizendo quem vai usar e para quê. A chave não libera nada além do acesso anônimo: só dá um limite próprio. Como enviar a chave →