# MYTI — dados públicos brasileiros (MCP)

> 6 domínios, 52 datasets, 9 ferramentas. Dados públicos brasileiros já limpos, tipados e com as ressalvas escritas ao lado de cada número.

Servidor MCP sobre HTTP com streaming. Autenticação por token no cabeçalho `Authorization: Bearer <token>`. Endpoint MCP: `https://mcp.myti.com.br/mcp`.

## O que existe

- **comercio-exterior** (11 datasets) — A balança comercial detalhada: cada operação de importação e exportação agregada por produto (NCM), país, unidade da federação, via de transporte e urf de despacho, de 2015 até o mês corrente. Fonte: Comex Stat / Secretaria de Comércio Exterior (MDIC).
- **compras-publicas** (13 datasets) — Duas fontes da mesma coisa, vista de ângulos diferentes, reunidas num domínio só. Fonte: PNCP (Portal Nacional de Contratações Públicas) e Comprasnet / Compras.gov.br.
- **empresas** (10 datasets) — O Cadastro Nacional da Pessoa Jurídica inteiro: 69,5 milhões de empresas, 72,8 milhões de estabelecimentos, 18,2 milhões de vínculos societários e 108 milhões de contatos, mais uma fila de 3,1 milhões de fornecedores já pontuada. Fonte: Receita Federal (dados abertos do CNPJ) e IBGE para a malha territorial.
- **indicadores** (3 datasets) — Séries de conjuntura brasileiras: inflação (IPCA e IPP), atividade (PIB, PIM, PMC, PMS, IBC-Br), emprego (PNAD Contínua), crédito e endividamento das famílias, câmbio e juros. Fonte: IBGE (API SIDRA) e Banco Central (API Olinda).
- **justica** (13 datasets) — O maior acervo desta casa: 6,5 milhões de processos, 5,1 milhões de instâncias, 230 milhões de movimentos processuais e 2,3 milhões de publicações de diário oficial com o texto inteiro. Fonte: CNJ — DataJud e Diário de Justiça Eletrônico Nacional.
- **pagamentos** (2 datasets) — Todo o Pix do país agregado por setor econômico de quem recebe, canal de iniciação, finalidade, porte e tipo de pessoa, mês a mês desde novembro de 2020. Fonte: Banco Central — API Olinda, conjunto de estatísticas do Pix.

## Ferramentas

- `procurar(termo)` — qual dataset responde a pergunta. **Comece aqui.**
- `guia(assunto?)` — como usar este servidor: filtros, paginação, receitas.
- `catalogo(dominio?)` — domínios, ou os datasets de um domínio.
- `descrever(dataset)` — grão, campos, valores reais, cobertura, ressalvas.
- `consultar(dataset, campos?, filtros?, agregar?, ordenar?, limite?, cursor?, contar?)`
- `buscar(dataset, termo, ...)` — texto livre, ordenado por relevância.
- `serie(dataset, medida, ...)` — pontos em ordem cronológica.
- `grafico(dataset, medida, ...)` — PNG pronto.
- `sql(consulta, dominio, limite?)` — somente leitura, para o que o declarativo não expressa.

## Documentação

- [Guia completo](https://mcp.myti.com.br/guia.md) — receitas, limites e o catálogo inteiro
- [Saúde](https://mcp.myti.com.br/saude) — domínios e contagem de datasets

## Três hábitos que evitam resposta errada

1. **Leia as ressalvas.** Vêm em `descrever` e em toda resposta. Cada uma corresponde a um erro que a forma do dado convida.
2. **Descubra o código antes de filtrar por ele.** CNAE, NCM e código de série são números; filtrar pelo nome devolve zero linhas.
3. **Pagine pelo cursor.** Se `paginacao.tem_mais`, repita com `cursor=paginacao.cursor_proximo`. Não invente offset.