# Anotaê • Documentação Completa (Receita Federal B2B & Servidor MCP Oficial)

> Referência técnica e comercial completa da plataforma Anotaê (https://dados.anotae.app.br), cobrindo 28.380.659 empresas ativas em todos os 27 Estados do Brasil a partir dos Dados Abertos oficiais da Receita Federal (CNPJ, CNAEs, QSA, Simples Nacional/MEI, Capital Social e Contatos).

---

## 1. Arquitetura e Identificação Oficial

- **Nome do Serviço:** Receita Federal do Brasil - Prospecção B2B & CNPJ (Anotaê)
- **Namespace no Official MCP Registry (`registry.modelcontextprotocol.io`):** `br.app.anotae.dados/mcp`
- **Portal Web de Prospecção B2B:** `https://dados.anotae.app.br/app`
- **Endpoint MCP (Streamable HTTP):** `https://dados.anotae.app.br/mcp`
- **Autenticação Suportada:**
  1. **OAuth 2.1 com PKCE (RFC 7636) e Dynamic Client Registration (RFC 7591):** Conexão em 1 clique no Claude Desktop, Claude.ai e clientes compatíveis.
  2. **API Key (`X-API-Key` ou `Authorization: Bearer <key>`):** Chaves pré-pagas (`mcp_live_...`) com saldo de créditos que nunca expiram.
  3. **Modo Trial Diário (`Authorization: Bearer trial` ou `X-API-Key: trial`):** Permite testar imediatamente as ferramentas MCP com cota diária gratuita renovada à meia-noite.

---

## 2. Como Configurar no Claude Desktop, Cursor, VS Code ou n8n

### Opção A: Conexão Remota via Streamable HTTP (Cursor / Windsurf / VS Code / MCP Clients)
```json
{
  "mcpServers": {
    "receita-federal-anotae": {
      "url": "https://dados.anotae.app.br/mcp",
      "headers": {
        "Authorization": "Bearer trial"
      }
    }
  }
}
```

### Opção B: Conexão no Claude.ai / Claude Desktop (Custom Connector)
1. Adicione a URL remota: `https://dados.anotae.app.br/mcp`
2. O fluxo OAuth 2.1 abrirá automaticamente a tela de autorização e liberará os créditos gratuitos de degustação.

---

## 3. Catálogo Completo de Ferramentas MCP (11 Tools)

1. **`search_providers_by_service`**
   - **Descrição:** Busca empresas e prestadores de serviços ativos usando busca semântica com IA (embeddings FastEmbed/ONNX) nos CNAEs principais e secundários + Full-Text Search BM25.
   - **Parâmetros:** `query` (str), `uf` (str, opcional), `municipio` (str, opcional), `bairro` (str, opcional), `regiao` (str, opcional — suporta regiões IBGE), `apenas_mei` (bool), `apenas_simples` (bool), `apenas_com_contato` (bool), `apenas_com_telefone` (bool), `apenas_com_email` (bool), `apenas_matriz` (bool), `capital_minimo` (float), `idade_minima_anos` (float), `idade_maxima_anos` (float), `limit` (int, padrão 15), `offset` (int, padrão 0).

2. **`get_provider_details`**
   - **Descrição:** Consulta a ficha cadastral completa de uma empresa ativa pelo CNPJ (com ou sem pontuação), retornando razão social, nome fantasia, porte (ME/EPP/Demais), capital social, situação no Simples/MEI, endereço completo, telefones, e-mail e Quadro de Sócios (QSA).
   - **Parâmetros:** `cnpj` (str).

3. **`get_company_partners`**
   - **Descrição:** Retorna o Quadro de Sócios e Administradores (QSA) oficial de uma empresa pelo CNPJ (nomes dos sócios, qualificações, data de entrada, faixa etária e documento mascarado).
   - **Parâmetros:** `cnpj` (str).

4. **`search_company_by_name`**
   - **Descrição:** Busca empresas ativas diretamente pela Razão Social ou Nome Fantasia, com filtro opcional de UF e Município.
   - **Parâmetros:** `name` (str), `uf` (str, opcional), `municipio` (str, opcional), `limit` (int, padrão 15).

5. **`get_biggest_companies_by_capital`**
   - **Descrição:** Lista as maiores empresas de um segmento ordenadas pelo Capital Social declarado na Receita Federal.
   - **Parâmetros:** `query` (str), `uf` (str, opcional), `municipio` (str, opcional), `limit` (int, padrão 5).

6. **`analyze_market_competition`**
   - **Descrição:** Executa análise competitiva de mercado com métricas agregadas: total de concorrentes ativos, capital social médio, idade média das empresas e ranking de bairros com maior concentração.
   - **Parâmetros:** `query` (str), `uf` (str, opcional), `municipio` (str, opcional).

7. **`export_leads_csv`**
   - **Descrição:** Exporta listagem enriquecida de leads comerciais B2B diretamente em formato CSV estruturado (RFC 4180), pronto para importação em CRMs ou Excel.
   - **Parâmetros:** Mesmos filtros de `search_providers_by_service` (`limit` até 50 por chamada).

8. **`listar_ufs_e_municipios`**
   - **Descrição:** Lista todos os Estados (UFs) e Municípios disponíveis na base com a contagem exata de empresas ativas.
   - **Parâmetros:** `uf` (str, opcional).

9. **`list_available_cities`**
   - **Descrição:** Lista os municípios atendidos na base com o total de empresas ativas em cada um.
   - **Parâmetros:** `uf` (str, opcional).

10. **`verificar_saldo_mcp`** *(Custo Zero)*
    - **Descrição:** Consulta quantas consultas gratuitas ainda restam na cota diária, o saldo de créditos pré-pagos e a tabela de pacotes disponíveis via Pix.

11. **`comprar_pacote_creditos_pix`** *(Custo Zero)*
    - **Descrição:** Gera instantaneamente um código Pix Copia-e-Cola (BR Code oficial BACEN) e link de checkout do Mercado Pago para recarga imediata de créditos pré-pagos no MCP.
    - **Parâmetros:** `pacote_id` (`starter_500`, `pro_2500`, `scale_10000`), `email` (str).

---

## 4. Templates de Prompts MCP Guiados (4 Prompts)

- **`prospeccao_leads_b2b(segmento, localidade, foco_contato)`**: Orquestra busca ativa de clientes B2B (SDR), qualificando contatos e sugerindo pitch de abordagem comercial.
- **`analise_competitiva_mercado(segmento, localidade)`**: Gera relatório executivo de saturação de mercado, barreiras de entrada e líderes por capital social.
- **`due_diligence_fornecedor(cnpj, contexto)`**: Realiza auditoria cadastral de conformidade, tempo de mercado, porte, QSA e coerência de CNAEs.
- **`diagnostico_expansao_regional(uf, regiao)`**: Diagnóstico de geomarketing usando divisões do IBGE para definir praças prioritárias de expansão comercial.

---

## 5. Páginas Regionais por Cidade (https://dados.anotae.app.br/empresas/...)

- [São Paulo - SP (2.760.370 empresas)](https://dados.anotae.app.br/empresas/sp/sao-paulo): DDD 11 | Principais bairros: Itaim Bibi, Pinheiros, Vila Mariana, Bela Vista, Moema.
- [Rio de Janeiro - RJ (1.067.458 empresas)](https://dados.anotae.app.br/empresas/rj/rio-de-janeiro): DDD 21 | Principais bairros: Barra da Tijuca, Centro, Copacabana, Botafogo, Tijuca.
- [Belo Horizonte - MG (541.912 empresas)](https://dados.anotae.app.br/empresas/mg/belo-horizonte): DDD 31 | Principais bairros: Savassi, Centro, Funcionários, Lourdes, Buritis.
- [Curitiba - PR (485.895 empresas)](https://dados.anotae.app.br/empresas/pr/curitiba): DDD 41 | Principais bairros: Centro, Batel, Água Verde, Cidade Industrial (CIC), Boqueirão.
- [Brasília - DF (420.110 empresas)](https://dados.anotae.app.br/empresas/df/brasilia): DDD 61 | Principais bairros: Asa Sul, Asa Norte, Taguatinga, Águas Claras, Ceilândia.
- [Fortaleza - CE (365.200 empresas)](https://dados.anotae.app.br/empresas/ce/fortaleza): DDD 85 | Principais bairros: Aldeota, Meireles, Centro, Messejana, Papicu.
- [Salvador - BA (340.150 empresas)](https://dados.anotae.app.br/empresas/ba/salvador): DDD 71 | Principais bairros: Caminho das Árvores, Pituba, Barra, Centro, Itapuã.
- [Goiânia - GO (325.400 empresas)](https://dados.anotae.app.br/empresas/go/goiania): DDD 62 | Principais bairros: Setor Bueno, Setor Marista, Setor Oeste, Centro, Jardim Goiás.
- [Porto Alegre - RS (310.800 empresas)](https://dados.anotae.app.br/empresas/rs/porto-alegre): DDD 51 | Principais bairros: Moinhos de Vento, Centro Histórico, Passo d'Areia, Petrópolis, Auxiliadora.
- [Campinas - SP (285.300 empresas)](https://dados.anotae.app.br/empresas/sp/campinas): DDD 19 | Principais bairros: Cambuí, Centro, Barão Geraldo, Taquaral, Jardim Guanabara.
- [Manaus - AM (240.900 empresas)](https://dados.anotae.app.br/empresas/am/manaus): DDD 92 | Principais bairros: Distrito Industrial, Adrianópolis, Centro, Nossa Senhora das Graças, Cidade Nova.
- [Recife - PE (235.600 empresas)](https://dados.anotae.app.br/empresas/pe/recife): DDD 81 | Principais bairros: Boa Viagem, Recife Antigo, Santo Amaro, Boa Vista, Imbiribeira.
- [Florianópolis - SC (148.900 empresas)](https://dados.anotae.app.br/empresas/sc/florianopolis): DDD 48 | Principais bairros: Centro, Trindade, Itacorubi, Estreito, Saco Grande.
- [Joinville - SC (132.400 empresas)](https://dados.anotae.app.br/empresas/sc/joinville): DDD 47 | Principais bairros: Zona Industrial Norte, Centro, América, Atiradores, Saguaçu.
- [Londrina - PR (118.500 empresas)](https://dados.anotae.app.br/empresas/pr/londrina): DDD 43 | Principais bairros: Centro, Gleba Palhano, Higienópolis, Cilo 2, Bela Suíça.
- [Maringá - PR (109.200 empresas)](https://dados.anotae.app.br/empresas/pr/maringa): DDD 44 | Principais bairros: Zona 01, Zona 07, Zona 03, Parque Industrial, Novo Centro.
- [Guarulhos - SP (210.400 empresas)](https://dados.anotae.app.br/empresas/sp/guarulhos): DDD 11 | Principais bairros: Cumbica, Centro, Vila Augusta, Macedo, Bonsucesso.
- [Ribeirão Preto - SP (165.800 empresas)](https://dados.anotae.app.br/empresas/sp/ribeirao-preto): DDD 16 | Principais bairros: Jardim Botânico, Centro, Ribeirânia, Nova Aliança, Campos Elíseos.
- [Sorocaba - SP (154.200 empresas)](https://dados.anotae.app.br/empresas/sp/sorocaba): DDD 15 | Principais bairros: Éden, Campolim, Centro, Zona Industrial, Santa Rosália.
- [Vitória - ES (98.700 empresas)](https://dados.anotae.app.br/empresas/es/vitoria): DDD 27 | Principais bairros: Enseada do Suá, Praia do Canto, Jardim da Penha, Centro, Jardim Camburi.
- [Cuiabá - MT (142.300 empresas)](https://dados.anotae.app.br/empresas/mt/cuiaba): DDD 65 | Principais bairros: Centro Norte, Bosque da Saúde, Distrito Industrial, Goiabeiras, CPA.
- [Campo Grande - MS (158.900 empresas)](https://dados.anotae.app.br/empresas/ms/campo-grande): DDD 67 | Principais bairros: Centro, Jardim dos Estados, Chácara Cachoeira, Vila Bandeirantes, Santa Fé.
- [Belém - PA (162.100 empresas)](https://dados.anotae.app.br/empresas/pa/belem): DDD 91 | Principais bairros: Nazaré, Umarizal, Batista Campos, Marco, Campina.
- [Uberlândia - MG (149.600 empresas)](https://dados.anotae.app.br/empresas/mg/uberlandia): DDD 34 | Principais bairros: Centro, Santa Mônica, Distrito Industrial, Tibery, Brasil.

---

## 6. Páginas por Segmento de Mercado B2B (https://dados.anotae.app.br/segmentos/...)

- [Clínicas Odontológicas e Consultórios Dentários (195.400+ empresas)](https://dados.anotae.app.br/segmentos/clinicas-odontologicas): CNAEs 8630-5/04 (Atividade odontológica). Ideal para: Fornecedores de materiais odontológicos (implantes, resinas, alinhadores), softwares de gestão clínica, agências de marketing médico, contabilidades especializadas na área da saúde e equipamentos de radiologia.
- [Restaurantes, Bares, Lanchonetes e Food Service (1.240.000+ empresas)](https://dados.anotae.app.br/segmentos/restaurantes-e-alimentacao): CNAEs 5611-2/01 (Restaurantes e similares), 5611-2/03 (Lanchonetes, casas de chá, de sucos e similares). Ideal para: Distribuidoras de alimentos e bebidas, sistemas PDV/ERP para restaurantes, adquirentes de maquininhas, embalagens para delivery, refrigeração comercial e energia solar.
- [Escritórios de Contabilidade, Auditoria e Consultoria Fiscal (210.800+ empresas)](https://dados.anotae.app.br/segmentos/escritorios-de-contabilidade): CNAEs 6920-6/01 (Atividades de contabilidade), 6920-6/02 (Consultoria e auditoria contábil e tributária). Ideal para: Sistemas contábeis e BPO financeiro, certificadoras digitais, plataformas de folha de pagamento, bancos PJ, consultorias de recuperação tributária e seguros corporativos.
- [Empresas de Energia Solar e Engenharia Elétrica (145.000+ empresas)](https://dados.anotae.app.br/segmentos/energia-solar): CNAEs 4321-5/00 (Instalação e manutenção elétrica), 7112-0/00 (Serviços de engenharia), 3511-5/01 (Geração de energia elétrica). Ideal para: Distribuidores de equipamentos fotovoltaicos (inversores, módulos), financiadoras de crédito solar, softwares de dimensionamento de projetos, seguradoras e fornecedores de estruturas metálicas.
- [Construtoras, Incorporadoras e Engenharia Civil (480.000+ empresas)](https://dados.anotae.app.br/segmentos/construtoras-e-engenharia): CNAEs 4120-4/00 (Construção de edifícios), 4110-7/00 (Incorporação de empreendimentos imobiliários), 7112-0/00 (Serviços de engenharia). Ideal para: Indústrias de materiais de construção, locadoras de máquinas e andaimes, aço, concreto, esquadrias, ERPs de gestão de obras, EPIs e medicina ocupacional (SST).
- [Transportadoras de Cargas, Logística e Frota Rodoviária (520.000+ empresas)](https://dados.anotae.app.br/segmentos/transportadoras-e-logistica): CNAEs 4930-2/02 (Transporte rodoviário de carga intermunicipal, interestadual e internacional), 4930-2/01 (Transporte rodoviário de carga municipal). Ideal para: Rastreamento veicular e telemetria, gestão de frotas e abastecimento, seguradoras de carga, recapagem de pneus, peças para caminhões, sistemas TMS/WMS e antecipação de fretes.
- [Agências de Marketing Digital, Publicidade e Propaganda (290.000+ empresas)](https://dados.anotae.app.br/segmentos/agencias-de-marketing): CNAEs 7311-4/00 (Agências de publicidade), 7319-0/02 (Promoção de vendas), 7319-0/04 (Consultoria em publicidade). Ideal para: Ferramentas de automação de marketing, CRMs, plataformas de disparo de WhatsApp, produtoras de vídeo, softwares de BI/relatórios e serviços de tráfego pago white-label.
- [Clínicas Médicas, Laboratórios e Clínicas de Estética (380.000+ empresas)](https://dados.anotae.app.br/segmentos/clinicas-medicas-e-estetica): CNAEs 8630-5/03 (Atividade médica ambulatorial restrita a consultas), 8630-5/02 (Atividade médica ambulatorial com recursos para exames), 9602-5/02 (Atividades de estética). Ideal para: Distribuidores de equipamentos estéticos (laser, ultrassom), dermocosméticos e injetáveis, prontuário eletrônico e telemedicina, secretárias virtuais com IA e contabilidade médica.
- [Empresas de Tecnologia, SaaS, Software e TI (440.000+ empresas)](https://dados.anotae.app.br/segmentos/tecnologia-e-software): CNAEs 6201-5/01 (Desenvolvimento de programas de computador sob encomenda), 6202-3/00 (Desenvolvimento e licenciamento de software customizável), 6204-0/00 (Consultoria em TI). Ideal para: Provedores de Cloud e infraestrutura, cibersegurança, recrutamento tech, APIs de dados (como o próprio MCP da Receita Federal), gateways de pagamento e BPO financeiro.
- [Supermercados, Atacadistas, Minimercados e Distribuidoras (610.000+ empresas)](https://dados.anotae.app.br/segmentos/supermercados-e-varejo): CNAEs 4711-3/02 (Supermercados), 4712-1/00 (Minimercados, mercearias e armazéns), 4639-7/01 (Comércio atacadista de produtos alimentícios). Ideal para: Indústrias de alimentos, bebidas e limpeza, sistemas de automação comercial e frente de caixa, gôndolas, câmaras frias, energia solar em mercado livre e logística.
- [Imobiliárias, Corretores de Imóveis e Administradoras (330.000+ empresas)](https://dados.anotae.app.br/segmentos/imobiliarias-e-corretagem): CNAEs 6821-8/01 (Corretagem na compra e venda e avaliação de imóveis), 6821-8/02 (Corretagem no aluguel de imóveis), 6822-6/00 (Gestão e administração da propriedade imobiliária). Ideal para: Portais imobiliários, CRMs para imobiliárias, garantidoras de aluguel e fiança locatícia, vistorias digitais, assinatura eletrônica e agências de tráfego imobiliário.
- [Indústrias de Transformação, Metalúrgicas e Fábricas (490.000+ empresas)](https://dados.anotae.app.br/segmentos/industrias-e-fabricas): CNAEs 2511-0/00 (Fabricação de estruturas metálicas), 2599-3/99 (Fabricação de outros produtos de metal), 2222-6/00 (Fabricação de embalagens de material plástico). Ideal para: Fornecedores de matérias-primas (aço, resinas, químicos), manutenção industrial, comercializadoras de energia no Mercado Livre, transporte de cargas, EPIs e crédito PJ.
- [Oficinas Mecânicas, Centros Automotivos e Autopeças (580.000+ empresas)](https://dados.anotae.app.br/segmentos/oficinas-mecanicas-e-autopecas): CNAEs 4520-0/01 (Manutenção e reparação mecânica de veículos automotores), 4530-7/03 (Comércio a varejo de peças e acessórios novos para veículos). Ideal para: Distribuidoras de autopeças, lubrificantes e baterias, elevadores automotivos e scanners de diagnóstico, softwares para oficinas e maquininhas com parcelamento em 12x.
- [Academias de Ginástica, Crossfit, Pilates e Centros Esportivos (115.000+ empresas)](https://dados.anotae.app.br/segmentos/academias-e-fitness): CNAEs 9313-1/00 (Atividades de condicionamento físico). Ideal para: Fabricantes de equipamentos de musculação, catracas biométricas e softwares de recorrência para academias, distribuidores de suplementos, vestuário fitness e climatização.
- [Escolas Particulares, Cursos Livres, Idiomas e Ensino (275.000+ empresas)](https://dados.anotae.app.br/segmentos/escolas-e-educacao): CNAEs 8513-9/00 (Ensino fundamental), 8520-1/00 (Ensino médio), 8593-7/00 (Ensino de idiomas), 8599-6/04 (Treinamento em desenvolvimento profissional). Ideal para: Sistemas de ensino e editoras didáticas, plataformas de gestão escolar e cobrança de mensalidades, robótica educacional, uniformes escolares e segurança patrimonial.
- [Pet Shops, Clínicas Veterinárias e Hospitais Veterinários (285.000+ empresas)](https://dados.anotae.app.br/segmentos/pet-shops-e-veterinarias): CNAEs 4789-0/04 (Comércio varejista de animais vivos e artigos para animais de estimação), 7500-1/00 (Atividades veterinárias), 9609-2/08 (Higiene e embelezamento de animais domésticos). Ideal para: Distribuidoras de rações, medicamentos veterinários e acessórios pet, softwares de agendamento de banho e tosa, planos de saúde pet e equipamentos laboratoriais veterinários.