sinapi MCP server
Commit Nov 10, 2026Allows AI assistants to search official Brazilian construction cost databases, compare state prices, and generate budgets with TCU-compliant BDI calculations.
Also known as VC202504/sinapi-mcp
- Stars
- 2
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 10, 2026
- License
- MIT
What is sinapi MCP?
sinapi allows AI assistants to search official Brazilian construction cost databases, compare state prices, and generate budgets with TCU-compliant BDI calculations.
Summary generated from the project's README
About sinapi MCP server
Civil engineers and construction professionals can access official Brazilian cost databases directly through AI assistants like Claude or Cursor. This server connects your local environment to major public sources including SINAPI, SICRO, ORSE, and SEINFRA. It functions by downloading official data into a local SQLite database, ensuring that all information remains private and is retrieved directly from government sources without passing through third-party servers.
Users can manage data through the atualizar_base tool to fetch the latest monthly or quarterly updates. The server provides specialized tools such as buscar_precos for searching materials, comparar_ufs to check price differences between states, and orcar to generate rapid budgets. It also includes a dedicated calcular_bdi tool that applies the specific formula from TCU Acórdão 2622/2013 to ensure markup calculations align with official regulatory ranges for different types of construction projects.
What you can do with it
- 1Search for material unit costsFind the specific price for a construction material or composition in a particular state.
- 2Compare regional price variationsIdentify the cheapest and most expensive states for a specific item to optimize procurement.
- 3Generate compliant construction budgetsCreate a budget estimate that includes direct costs and a calculated BDI markup.
- 4Verify regulatory BDI complianceCheck if a proposed markup percentage falls within the official TCU guidelines.
Written from the project's README. Every use case is checked against a quote from it.
Configuration
SINAPI_MCP_UF
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablevc202504/sinapi-mcp is public and reachablegithub.com/vc202504/sinapi-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/vc202504/sinapi-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubsinapi-mcp
Preços oficiais de obras do Brasil dentro do Claude, do Cursor e de qualquer assistente compatível com MCP.
SINAPI (Caixa e IBGE), SICRO (DNIT), ORSE (CEHOP, Sergipe) e SEINFRA (Ceará): o servidor baixa as tabelas direto dos sites oficiais, guarda num banco local e deixa a IA buscar composições e insumos, comparar UFs, ver a evolução do preço no tempo, montar um orçamento rápido e calcular o BDI pelo Acórdão 2622/2013 do TCU.
English summary at the end.
O que dá para pedir
Quanto custa o m² de alvenaria de bloco cerâmico 9x19x19 na Paraíba, sem desoneração?
Monte um orçamento com 120 m² de alvenaria 103328 e 8,5 m³ de concreto C25 34493 na PB, com BDI de 22,12 %.
Compare o preço do cimento CP II-32 entre os estados.
Esse BDI está dentro das faixas do TCU para edificações? AC 4, seguro e garantia 0,8, risco 1,27, despesas financeiras 1,23, lucro 7,4, ISS 2,5.
Resposta típica do orcar:
| # | Código | Descrição | Un. | Qtd. | Unitário | Total | Fonte |
|---|---|---|---|---|---|---|---|
| 1 | 103328 | ALVENARIA DE VEDAÇÃO DE BLOCOS CERÂMICOS FURADOS NA HORIZONTAL DE 9X19X19 CM (ESPESSURA 9 CM)... | M2 | 120 | R$ 104,84 | R$ 12.580,80 | SINAPI PB 09/2026 sem desoneração |
| 2 | 34493 | CONCRETO USINADO BOMBEAVEL, CLASSE DE RESISTENCIA C25, COM BRITA 0 E 1, SLUMP = 100 +/- 20 MM... | M3 | 8,5 | R$ 580,92 | R$ 4.937,82 | SINAPI PB 09/2026 sem desoneração |
Custo direto: R$ 17.518,62 · BDI (22,12 %): R$ 3.875,12 · Total com BDI: R$ 21.393,74
Ferramentas
| Ferramenta | O que faz |
|---|---|
atualizar_base |
Baixa a competência mais recente (ou a pedida) do site oficial e grava no banco local |
buscar_precos |
Busca por palavras ou código, sem precisar de acento, em uma base ou em todas |
detalhar_item |
Descrição completa, grupo e todos os preços guardados do item (evolução no tempo) |
comparar_ufs |
O mesmo item em todas as UFs, do mais barato ao mais caro, com a diferença para a média |
orcar |
Código × quantidade × preço, com BDI sobre o custo direto |
calcular_bdi |
Fórmula do Acórdão 2622/2013-TCU e comparação com as faixas por tipo de obra |
bases_disponiveis |
O que já está no banco local |
Bases
| Base | Órgão | Cobertura | Periodicidade | Download |
|---|---|---|---|---|
| SINAPI | Caixa e IBGE | 27 UFs, composições e insumos, sem e com desoneração | mensal | cerca de 16 MB, menos de 1 minuto |
| SICRO | DNIT | obras rodoviárias, composições e materiais, por UF | trimestral | por UF, cerca de 1 minuto |
| ORSE | CEHOP (SE) | serviços, inclusive itens que o SINAPI não traz | mensal | leitura da consulta pública, alguns minutos |
| SEINFRA | Governo do Ceará | serviços e insumos, sem e com desoneração | por versão | cerca de 1 minuto |
Tudo vem das fontes públicas originais, no momento em que você pede. Nenhum dado passa por servidor de terceiros. As competências antigas ficam guardadas, então um orçamento pode ser refeito com os preços da sua data.
Instalação
Precisa do uv (ou de Python 3.10+ com pip).
Claude Code
claude mcp add sinapi -e SINAPI_MCP_UF=PB -- uvx --from "sinapi-mcp[sicro] @ git+https://github.com/VC202504/sinapi-mcp" sinapi-mcp
Claude Desktop, Cursor, Windsurf e outros
No arquivo de configuração de servidores MCP (no Claude Desktop: Configurações ▸ Desenvolvedor ▸ Editar configuração):
{
"mcpServers": {
"sinapi": {
"command": "uvx",
"args": ["--from", "sinapi-mcp[sicro] @ git+https://github.com/VC202504/sinapi-mcp", "sinapi-mcp"],
"env": { "SINAPI_MCP_UF": "PB" }
}
}
}
SINAPI_MCP_UF é a UF padrão das buscas (opcional). SINAPI_MCP_DADOS muda a pasta do banco (padrão:
%LOCALAPPDATA%\sinapi-mcp no Windows, ~/.local/share/sinapi-mcp no Linux e no macOS).
Linha de comando
pip install "sinapi-mcp[sicro] @ git+https://github.com/VC202504/sinapi-mcp"
sinapi-mcp atualizar SINAPI # 27 UFs, os dois regimes
sinapi-mcp atualizar SICRO --uf PB,PE
sinapi-mcp buscar "concreto usinado c25" --uf PB
sinapi-mcp bases
Dica: rode o atualizar do SINAPI uma vez pela linha de comando antes de usar no assistente, para a primeira
conversa já começar com a base pronta.
Como funciona
assistente de IA ⇄ MCP (stdio) ⇄ sinapi-mcp ⇄ banco SQLite local (busca de texto FTS5)
│
└─ atualizar_base: Caixa, DNIT, CEHOP e SEINFRA-CE
- A busca ignora acentos, aceita o começo das palavras ("bombeado" acha "bombeável") e, quando nenhum item tem todas as palavras, devolve os que têm mais.
- Os preços são custos unitários sem BDI, como publicados pelos órgãos.
- O SICRO vem em
.7z; o extra[sicro]instala opy7zr(ou use o 7-Zip instalado). - Uma importação que chega com poucos itens (sinal de que o órgão mudou o formato) não é gravada.
Avisos
Ferramenta de apoio. Preço de referência não substitui a análise do profissional habilitado, e o orçamento final, a ART e as escolhas de composição continuam sendo responsabilidade de quem assina. Confira as faixas de BDI no texto oficial do acórdão antes de usar em processo. O projeto não tem vínculo com a Caixa, o IBGE, o DNIT, a CEHOP ou a SEINFRA.
Contribuindo
Issues e pull requests são bem-vindos, principalmente para novas bases estaduais (SETOP-MG, EMOP-RJ, SIURB-SP, SUDECAP, AGETOP) e para composições analíticas.
git clone https://github.com/VC202504/sinapi-mcp && cd sinapi-mcp
python -m venv .venv && .venv/bin/pip install -e ".[dev,sicro]"
.venv/bin/pytest
Autor
Kenyo Veloso Chianca, engenheiro civil. Os leitores das bases nasceram no BLOCKINFRA, programa de projeto de infraestrutura e orçamento.
Licença MIT.
English summary
MCP server that gives AI assistants (Claude, Cursor, etc.) access to Brazil's official construction cost databases: SINAPI (Caixa/IBGE, all 27 states, monthly), SICRO (DNIT, roads), ORSE (Sergipe) and SEINFRA (Ceará). It downloads the public files straight from the government sources into a local SQLite/FTS5 database, then exposes tools to search items, compare prices across states, track price history, build quick budgets and compute BDI (markup) using the formula and reference ranges of Brazil's Federal Court of Accounts (TCU Ruling 2622/2013).
claude mcp add sinapi -- uvx --from "sinapi-mcp[sicro] @ git+https://github.com/VC202504/sinapi-mcp" sinapi-mcp
sinapi MCP questions
What official databases are included?
The server includes SINAPI (Caixa and IBGE), SICRO (DNIT), ORSE (CEHOP, Sergipe), and SEINFRA (Ceará).
Can I calculate BDI according to TCU standards?
Yes, the server can calculate BDI using the formula from TCU Ruling 2622/2013 and compare it with official reference ranges.
Does the data pass through third-party servers?
No, all data is downloaded directly from official government sources and stored in a local database.
Can I compare prices between different Brazilian states?
Yes, the tool allows you to compare the same item across different UFs (states), ranking them from cheapest to most expensive.