Model Context Protocol

Os dados oficiais de São Paulo, direto na sua IA

O MCP SEADE expõe datasets e indicadores oficiais da Fundação SEADE como ferramentas consumíveis por assistentes de IA — de forma segura, estruturada e em tempo real.

Datasets públicos
0
Domínios temáticos
0
Ferramentas MCP
31
Registros
0
Fluxo

Como funciona

Do assistente de IA até as estatísticas oficiais da SEADE, em quatro passos.

01

Conecte sua ferramenta

Claude, Cursor, Windsurf ou qualquer cliente MCP se conecta ao servidor enviando sua API Key.

02

A IA consulta as ferramentas

O assistente chama as ferramentas MCP (listar, buscar, agregar, comparar) conforme a pergunta do usuário.

03

Dados oficiais são lidos

O MCP SEADE consulta os datasets da Fundação SEADE de forma segura e somente-leitura.

04

O contexto enriquece a resposta

Os dados retornam estruturados e em tempo real, embasando a resposta da IA com estatísticas oficiais.

Conexão

Integrações

Configure o MCP SEADE nas principais ferramentas de IA. Toda requisição usa o cabeçalho x-api-key (ou ?key= na URL).

Acesso público

Os snippets abaixo já vêm com a chave pública da SEADE, que dá acesso somente-leitura a todos os datasets públicos — sem precisar solicitar nada. Basta copiar e usar.

Acesso a dados restritos

Alguns datasets são restritos. Para acessá-los, solicite uma chave de domínio própria à Fundação SEADE — ela limita o acesso apenas aos datasets autorizados ao seu domínio.

Solicitar acesso ampliado
claude mcp add seade \
  --transport http \
  --url https://mcp.seade.gov.br/mcp \
  --header "x-api-key: pk_4e23db57ace458986e9df2e22993199288c50e881a1393bf"

O conector nativo do Claude.ai (web) ainda não é suportado (exige OAuth 2.1); use a variante com ?key= na URL ou os clientes acima.

Catálogo

Dados disponíveis

Todos os datasets públicos deste servidor, organizados por domínio temático. Selecione um domínio para ver seus dados e a chave de acesso correspondente.

Filtrar por domínio

0 datasets encontrados

Nenhum dataset disponível no momento.

Capacidades

Ferramentas MCP

O que o assistente de IA pode fazer com os dados da SEADE. Filtre por categoria ou busque pelo nome da ferramenta.

31 ferramentas disponíveis
agregar_dadosAnálise

Realiza agregações estatísticas sobre um dataset da Fundação SEADE.

amostra_datasetConsulta

Retorna uma amostra aleatória de linhas de um dataset. Útil para entender o formato, conteúdo e exemplos de dados reais presentes, com baixíssimo custo computacional, pois extrai aleatoriamente sem necessidade de ler todo o arquivo (USING SAMPLE).

analisar_serie_temporalAnálise

Analisa a evolução de um indicador ao longo do tempo: monta a série (período × valor), calcula variação total (absoluta e %), CAGR (taxa de crescimento anual composta), tendência (alta/baixa/estável), média móvel opcional e cruza com as quebras de série conhecidas do dataset.

avaliar_comparacaoGovernança

Avalia se uma comparação é metodologicamente VÁLIDA antes de fazê-la: detecta quebras de série temporal, mudanças de malha territorial, redefinições de conceito e unidades inconsistentes que podem invalidar a comparação.

baixar_csvExportação

Retorna o conteúdo original do dataset ou instrução de obtenção rápida.

buscar_colunaDescoberta

Busca colunas em todos os datasets usando linguagem natural e similaridade semântica (embeddings VSS). Útil quando você não sabe o nome exato de uma coluna mas sabe o que ela representa.

buscar_contextoDescoberta

Descobre quais datasets são relevantes para responder uma pergunta em linguagem natural. Usa busca semântica nos metadados e colunas para encontrar os datasets mais adequados, retornando uma visão macro agrupada por dataset com título, descrição, tema e as colunas mais relevantes.

buscar_dadosConsulta

Busca e filtra dados em um dataset específico da Fundação SEADE.

buscar_documentacaoDescoberta

Busca semântica na documentação/metodologia curada (Knowledge Layer): "como este indicador é calculado?", metodologia, notas técnicas, limitações metodológicas.

buscar_indicadoresDescoberta

Catálogo de indicadores (métricas) disponíveis, por tema ou termo de busca. Retorna apenas colunas com papel analítico de MÉTRICA (valores agregáveis), com sua unidade de medida, o dataset de origem, as dimensões de recorte disponíveis e a cobertura temporal.

calcular_variacaoAnálise

Calcula a variação (absoluta e percentual) de um indicador entre dois pontos de uma dimensão (ex.: dois anos, duas regiões). Lida com valores em formato brasileiro (R$, milhar).

comparar_dadosAnálise

Compara dados entre períodos, regiões ou categorias de um dataset SEADE.

consultar_dicionarioDescoberta

Retorna o dicionário de dados completo de um dataset da Fundação SEADE.

consultar_metodologiaDescoberta

Retorna o registro metodológico estruturado de um dataset da Fundação SEADE: metodologia, limitações de uso, quebras de série temporal, definições conceituais, fonte, URL da fonte, licença e data de atualização.

descrever_datasetConsulta

Retorna características estruturais de um dataset (total de linhas, tipos, estatísticas). Útil para entender a dimensão e a qualidade dos dados antes de fazer agregações pesadas.

detectar_tendenciasAnálise

Detecta padrões em MUITAS entidades de uma vez: crescimento/declínio ao longo do tempo (regressão linear por entidade) e outliers (territórios que destoam dos demais).

executar_sqlAnálise

Executa uma consulta SQL customizada (APENAS SELECT) em um ou mais datasets. Ferramenta avançada para subqueries, window functions e JOINs entre datasets.

explicar_datasetDescoberta

Explica em linguagem natural o que um dataset da Fundação SEADE mede: do que se trata, o que mede, sua cobertura temporal e territorial, periodicidade, principais indicadores, dimensões de recorte, limitações de uso e fonte/licença.

explicar_limitacoesGovernança

Lista os riscos de interpretação de um dataset (ou de uma coluna específica): limitações declaradas, quebras de série, notas de interpretação e completude dos dados.

get_map_layers_registryGeoespacial

Retorna o catálogo de malhas vetoriais (camadas geoespaciais) disponíveis na Fundação SEADE para construção de mapas temáticos.

listar_datasetsDescoberta

Lista todos os conjuntos de dados (datasets) disponíveis da Fundação SEADE.

listar_dimensoes_chavesDescoberta

Expõe a "anatomia analítica" de um dataset: separa as colunas por papel — métricas (valores agregáveis), dimensões (recortes/categorias), chaves temporais, chaves territoriais e identificadores.

planejar_analiseAnálise

Copiloto de análise: a partir de uma pergunta em linguagem natural, monta um PLANO EXECUTÁVEL (sem executar). Interpreta a intenção, descobre os datasets relevantes (busca semântica), expõe os indicadores/dimensões/chaves disponíveis, sugere recortes e normalizações, e devolve uma sequência de passos (quais tools chamar, com quais argumentos e por quê), além das ressalvas metodológicas conhecidas.

preparar_dados_mapaGeoespacial

Prepara um dataset + métrica para um mapa temático (coroplético): agrega o valor por território (chave de junção da malha), anexa a URL da malha e o geo_join_key, sugere classes de cores (quantis / intervalos iguais) e reporta a cobertura (territórios esperados × presentes × faltantes).

ranquear_territoriosAnálise

Gera um ranking de territórios por um indicador, com posição e percentil. Suporta normalização opcional dividindo por uma coluna denominador (ex.: per capita) com um fator (ex.: 100000 para "por 100 mil habitantes").

resolver_territorioGeoespacial

Resolve um território por nome ou código: retorna suas representações (código, nome, nível, sistema de código) e se é mapeável (qual malha/geo_join_key usar).

resumo_analiticoAnálise

Síntese estruturada de um dataset: destaques, estatísticas-chave da métrica principal, cobertura (temporal/territorial), valores notáveis (ex.: maiores territórios) e ressalvas metodológicas. Combina metadados + estatísticas calculadas sobre os dados (formato BR tratado).

sugerir_normalizacaoGovernança

Recomenda como tornar uma métrica comparável entre territórios ou no tempo (per capita, por 100 mil, percentual do total, índice base 100), avaliando a viabilidade e sugerindo o denominador. Alerta se a métrica JÁ é normalizada (taxa, %, índice) — caso em que normalizar de novo seria erro.

validar_compatibilidade_territorialGeoespacial

Verifica se um dataset "casa" com uma malha geográfica (resolution) ANTES de montar um mapa. Compara os códigos territoriais distintos do dataset com as features da malha e retorna os códigos que faltam de cada lado — evitando mapas com "buracos silenciosos" (municípios sem cor) ou dados sem geometria.

validar_consultaGovernança

Faz um "dry-run" de uma consulta ANTES de executá-la: valida se as colunas existem, se os operadores de filtro são válidos, se os valores estão dentro do domínio/faixa conhecidos, e se as agregações fazem sentido (ex.: não somar uma taxa ou um percentual).

verificar_compatibilidadeGovernança

Verifica se é SEGURO cruzar (JOIN) dois ou mais datasets da Fundação SEADE. Checa se usam o mesmo sistema de código territorial (IBGE7 vs nome vs cod_seade), a mesma granularidade temporal, e se há sobreposição de cobertura temporal. Sugere as chaves de junção e um exemplo de SQL.

Recursos (Resources)

6

Documentos de contexto que a IA pode ler diretamente

  • seade://catalogo

    Lista completa de todos os datasets disponíveis da Fundação SEADE

  • seade://datasets/{dataset_id}/dicionario

    Definição completa das colunas de um dataset específico

  • seade://datasets/{dataset_id}/metodologia

    Registro metodológico: metodologia, limitações, quebras de série, fonte e licença

  • seade://datasets/{dataset_id}/qualidade

    Completude, frescor e rastreabilidade (origem CKAN, ingestão, hash)

  • seade://glossario

    Glossário auto-derivado: temas e seus principais indicadores (métricas) com definições.

  • seade://territorios

    Resoluções/malhas geográficas disponíveis (município, RA, RG, RM) e suas chaves de junção

Prompts (fluxos guiados)

4

Roteiros prontos de análise que o assistente pode executar

  • comparar_territorios

    Comparar um indicador entre territórios com segurança metodológica.

  • explorar_tema

    Descobrir datasets e indicadores sobre um tema, do macro ao específico.

  • montar_mapa_tematico

    Preparar um mapa coroplético de um indicador, sem buracos.

  • planejar_analise_guiada

    Transformar uma pergunta em um plano executável e conduzi-lo até a resposta.