Integração de IA

Dados municipais com contrato explícito

O serviço autenticado oferece a mesma consulta municipal pela API e pelo MCP. Cenários aprovados também podem gerar fichas, relatórios e miniaplicações privadas.

Endpoint MCP

https://mapfrygeo.com/mcp

Use Authorization: Bearer <token OAuth> para OAuth ou X-API-Key: <chave> para chave individual. Nunca envie ambos. A chave nunca deve ir na URL, no corpo ou no prompt.

Gerenciar integrações

Client credentials ainda não anunciado

API HTTPS

https://mapfrygeo.com/api/public/v1

Disponibiliza catálogo, resolução, pesquisa, inspeção, análise síncrona recuperável, relatórios privados, estudos e evidências. Uma chave nova começa bloqueada; valide-a antes de conectar o cliente MCP. Use x-mapfry-workspace-id quando houver mais de um workspace concedido.

Validar chave (POST): https://mapfrygeo.com/api/public/v1/verify-key
Contrato OpenAPI (GET): https://mapfrygeo.com/api/public/v1/openapi.json

Ferramentas atuais

Ajuda Mapfry

Disponível por concessão

Descobre operações autorizadas e explica fluxos sem executá-los.

mapfry_help

Resolver referências

Disponível por concessão

Resolve municípios e conjuntos territoriais versionados.

mapfry_resolve

Inspecionar objetos

Disponível por concessão

Consulta objetos, execuções, perfis e evidências sem recalcular.

mapfry_inspect

Pesquisar municípios

Disponível por concessão

Pesquisa municípios com filtros explícitos e paginação.

mapfry_search

Analisar capacidade

Disponível por concessão

Prepara, aprova e executa cenários determinísticos autorizados.

mapfry_analyze

Renderizar

Disponível por concessão

Produz fichas, relatórios e miniaplicações privadas a partir de cenários autorizados.

mapfry_render

Registrar

Disponível por concessão

Prepara e confirma estudos vinculados a execuções.

mapfry_record

Auditar

Disponível por concessão

Consulta evidência e reprodutibilidade de objetos autorizados.

mapfry_audit

Indicadores habilitados para capacidade

Classes domiciliares

Domicílios classe AReconstrução inferidarenda_por_domicilio_classe_a
Domicílios classe AAReconstrução inferidarenda_por_domicilio_classe_aa
Domicílios classe B1Reconstrução inferidarenda_por_domicilio_classe_b1
Domicílios classe B2Reconstrução inferidarenda_por_domicilio_classe_b2
Domicílios classe C1renda_por_domicilio_classe_c1
Domicílios classe C2Reconstrução inferidarenda_por_domicilio_classe_c2
Domicílios classe DReconstrução inferidarenda_por_domicilio_classe_d
Domicílios classe EReconstrução inferidarenda_por_domicilio_classe_e

Composições de classes

Domicílios das classes AA e AReconstrução inferidadomicilios_classes_aa_a
Domicílios das classes B1 e B2Reconstrução inferidadomicilios_classes_b1_b2
Domicílios das classes C1 e C2Reconstrução inferidadomicilios_classes_c1_c2
Domicílios das classes D e EReconstrução inferidadomicilios_classes_d_e

Composições domiciliares

Casas, vilas e condomíniosReconstrução inferidadomicilios_casas_e_condominios
Domicílios com 2 ou mais moradoresReconstrução inferidadomicilios_com_2_ou_mais_moradores
Domicílios com 3 ou mais moradoresReconstrução inferidadomicilios_com_3_ou_mais_moradores
Domicílios própriosReconstrução inferidadomicilios_proprios

Composições etárias

Pessoas com 50 anos ou maispopulacao_50_anos_ou_mais
Pessoas de 0 a 19 anospopulacao_0_a_19_anos
Pessoas de 20 a 39 anospopulacao_20_a_39_anos
Pessoas de 20 a 49 anospopulacao_20_a_49_anos
Pessoas de 30 a 49 anospopulacao_30_a_49_anos
Pessoas de 40 a 64 anospopulacao_40_a_64_anos

Domicílios

Apartamentosdomicilios_por_tipo_apartamentos
Casasdomicilios_por_tipo_casas
Casas de vila ou condomínioReconstrução inferidadomicilios_por_tipo_casas_de_vila_ou_condominios
Domicílios AA, A, B1 e B2domicilios_classes_aa_a_b1_b2
Domicílios AA, A, B1, B2, C1 e C2domicilios_classes_abc
Domicílios alugadosdomicilios_por_aquisicao_alugados
Domicílios com 1 moradorReconstrução inferidamoradores_por_domicilio_1_morador
Domicílios com 2 moradoresmoradores_por_domicilio_2_moradores
Domicílios com 3 moradoresmoradores_por_domicilio_3_moradores
Domicílios com 4 moradoresReconstrução inferidamoradores_por_domicilio_4_moradores
Domicílios com 5 ou mais moradoresReconstrução inferidamoradores_por_domicilio_5_ou_mais_moradores
Domicílios habitados (DPP)dompp_26
Domicílios próprios e quitadosdomicilios_por_aquisicao_proprios_e_quitados
Domicílios próprios em aquisiçãoReconstrução inferidadomicilios_por_aquisicao_proprios_em_aquisicao
Outras condições de ocupaçãoReconstrução inferidadomicilios_por_aquisicao_outras_condicoes_de_ocupacao
Outros tipos de domicílioReconstrução inferidadomicilios_por_tipo_outro_tipo

Outras contagens

Total de domicilios total de domiciliostotal_de_domicilios_total_de_domicilios

População por idade

Pessoas com 65 anos ou maispopulacao_por_idade_idosos_65_ou_mais_anos
Pessoas de 0 a 9 anospopulacao_por_idade_criancas_0_a_9_anos
Pessoas de 10 a 19 anospopulacao_por_idade_adolescentes_10_a_19_anos
Pessoas de 20 a 29 anospopulacao_por_idade_jovens_20_a_29_anos
Pessoas de 30 a 39 anospopulacao_por_idade_jovens_adultos_30_a_39_anos
Pessoas de 40 a 49 anospopulacao_por_idade_adultos_40_a_49_anos
Pessoas de 50 a 64 anospopulacao_por_idade_meia_idade_50_a_64_anos
População totalpopulacao

DPP habitados é o padrão domiciliar. Percentuais permanecem frações de 0 a 1 e são formatados apenas na apresentação.

Parâmetros exigidos

1. Composição de mercado: indicador absoluto ou até cinco grupos ponderados compatíveis.
2. Público-alvo no target: contagem mínima da composição que viabiliza uma unidade.
3. Restrição geográfica: regiões e UFs incluídas ou excluídas da expansão.
4. Rede atual: quantidades, data, escopo e cobertura; omissão não significa zero.
5. Aprovação: handle persistido vinculado à proposta, prévia, versões, orçamento e validade.

Contratos preparados para evolução

catalog

Consultar indicadores, unidade, universo, período, papéis e restrições.

municipality

Consultar campos municipais selecionados com versão e proveniência.

validateScenario

Validar cenário completo e rede sem executar estimativa não aprovada.

estimateExpansion

Executar o mesmo motor com cenário completo, cobertura e memória de cálculo.

A análise remota, os artefatos privados profile_card, report e mini_app, estudos e evidências de reprodutibilidade estão disponíveis por concessão. O mapa permanece bloqueado até existir cartografia municipal licenciada e versionada; comparação, publicação aberta e registros genéricos continuam reservados.

Dados e limites do método

Serviço: 2.0.0
API: v1
Prévia: 10 minutos
Código incorporável: 2 minutos
Sessão incorporável: até 15 minutos
Retenção: conforme concessão
Tabela: municipios
Dados: f950d301d3d03fe4
Catálogo: e318f7f3d02a5092
Cálculo: 2.0.0

O resultado estima capacidade municipal sob critérios de mercado. A base não contém fluxo de pedestres, concorrentes, acessibilidade, pontos disponíveis, aluguel, faturamento, margem, áreas de influência ou canibalização. A rede existente não calibra o critério por unidade e a ferramenta não garante viabilidade econômica.