PNCP

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Oct 24, 2026

Search Brazilian government tenders and public procurement (PNCP): find notices and auctions by keyw

The publisher's own server: pncp.dev

Overview

AI-generated overview

Lets an assistant search Brazilian public procurement (PNCP) data: tenders, bids, results, contracts, price records and planning.

What you can do
Provides 13 read-only tools over the Brazilian government procurement system (PNCP). Tools search tenders and open bids by keyword, value range, state, modality and period; return full detail of a procurement with items and prices; identify winning suppliers; list edital documents with download links and full edital text in markdown; and query contracts, price-registration minutes, annual procurement plans and buying agencies.
When to use it
Useful when an assistant needs to find Brazilian public tenders or bidding opportunities, check who won a specific procurement, review contract or price-record data, or read and summarize edital documents. It is aimed at suppliers, analysts and researchers working with Brazilian public procurement.
Requirements
A remote hosted MCP endpoint over HTTP; no credentials are required. Any MCP client that supports MCP over HTTP works, including Claude, Cursor, VS Code, ChatGPT and custom agents. Usage is prepaid via a credit wallet and billed per use.
Before you install
The service is paid: prepaid credits are consumed per use. Data returned by the tools is sent to the LLM host you choose, which is a sub-processor outside the provider's control; plans with training opt-out are recommended. All tools are read-only and do not modify source data.

Installation

In SourceWeft

  1. Open PNCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fpncp-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "pncp": {
      "type": "http",
      "url": "https://api.mcp.ai/p_pncp"
    }
  }
}

README

This repository has no README.

Tools

19

pncp_buscar

Busca licitações por PALAVRA-CHAVE no objeto (cobertura NACIONAL ampla, índice full-text), em editais, atas ou contratos. Retorna órgão, estado, município, modalidade, situação, datas e a referência (cnpj/ano/sequencial) pra detalhar. Aceita VÁRIOS termos em `termos[]`: cada um vira uma busca separada (disparadas com um intervalo entre si pra não pegar rate limit), e os resultados voltam fundidos e deduplicados numa lista só, com `termos_buscados`. IMPORTANTE: a busca full-text NÃO traz valor (vem sempre null) e não filtra por valor. Pra filtrar/ordenar por VALOR use pncp_listar (com apenas_abertas + termos + valor_min/valor_max) ou pncp_historico (faixa de valor sobre a base acumulada).

Parameterstipotermopaginastatustermosordenacaotam_pagina

pncp_listar

Busca PRINCIPAL de licitações abertas por palavra-chave, faixa de VALOR, estado, modalidade e período. Cobertura agregada e instantânea de vários portais. Já vem com VALOR estimado por item e RANQUEADA por valor (maior 1º) automaticamente. Os `termos` são EXPANDIDOS em sinônimos automaticamente (ex.: 'software' busca também saas, licença de uso, sistema...). TUDO opcional: sem datas, usa os próximos 30 dias por abertura. Use termos[] pra palavra-chave, valor_min/valor_max pra faixa, uf/modalidade pra estreitar; apenas_abertas=true (default). Cada item traz `id` + `valor`; pra itens/preços e leitura do edital use pncp_processo/pncp_texto. Passe incluir_valor:false pra uma lista rápida sem valor, ou expandir:false pra não expandir os termos. Modalidades: 1 Leilão-Elet, 4 Concorrência-Elet, 6 Pregão-Elet, 8 Dispensa, 9 Inexigibilidade, 12 Credenciamento.

Parametersufcnpjpaginatermosexpandirmunicipioordenacaovalor_maxvalor_mindata_finalmodalidadedata_inicial+3 more

pncp_oportunidades

Busca de OPORTUNIDADES de licitação (editais/pregões) com filtros ricos por palavra-chave, FAIXA DE VALOR da compra, UFs, modalidades, portais, registro de preço, participação exclusiva ME/EPP e superoportunidades. Cobertura agregada de vários portais. Devolve uma página com o `id` de cada oportunidade (use em pncp_processo pro detalhe completo), datas de abertura/encerramento e, quando `edital_legivel:true`, os campos `cnpj`/`ano`/`sequencial` pra LER o edital com pncp_texto/pncp_arquivos. Mesma fonte da pncp_listar, com mais filtros de qualificação.

Parametersufstermopaginatermosexcluirportaisexpandirtipo_itemvalor_maxvalor_mindata_finalmodalidades+8 more

pncp_processo

Detalhe de oportunidade(s) por `id` (de pncp_listar/pncp_oportunidades). DOIS modos: (1) `id` único → detalhe COMPLETO (objeto, situação, órgão, modalidade, ITENS com preços, `valor` estimado, datas) + `cnpj`/`ano`/`sequencial` pra LER o edital (pncp_texto/pncp_arquivos). (2) `ids` em LOTE → detalha vários numa só chamada (com throttle interno) e devolve RANKING por VALOR (maior 1º) — é a forma certa de RANQUEAR POR VALOR, já que a listagem não traz valor. Passe os `id` da página do pncp_listar em `ids` pra montar o ranking sem N chamadas.

Parametersidids

pncp_detalhe

Detalhe completo de uma licitação/contratação a partir de cnpj+ano+sequencial (a referência devolvida pela pncp_buscar). Com itens=true, inclui os itens da contratação com preços unitários, essencial pra pesquisa de preços. Com resultado=true, anexa o bloco `resultado` com o(s) fornecedor(es) vencedor(es) homologado(s).

Parametersanorequiredcnpjrequireditensresultadosequencialrequired

pncp_resultado

Quem GANHOU a licitação: o(s) fornecedor(es) vencedor(es) homologado(s) a partir de cnpj+ano+sequencial (a referência da pncp_buscar). Retorna, por vencedor, o CNPJ, a razão social, o valor REAL homologado (já com o desconto da disputa, melhor que o estimado), a natureza jurídica (separa estatal de privada, ex.: 'Empresa Pública') e o porte (ME/EPP vs Demais). Agrega por fornecedor (vários itens do mesmo vencedor viram uma linha) e traz o total homologado. Itens sem resultado são ignorados. Use numero_item pra um item específico; omita pra todos. Observação: a lista de PERDEDORES e os lances não vêm por aqui (só no Termo).

Parametersanorequiredcnpjrequiredsequencialrequirednumero_item

pncp_arquivos

Documentos de uma licitação/edital (edital, termo de referência, anexos) com o LINK de download de cada arquivo (em geral PDF). A partir de cnpj+ano+sequencial (a referência devolvida pela pncp_buscar). Use pra trazer o PDF do edital pro usuário ou pra outra IA ler o conteúdo.

Parametersanorequiredcnpjrequiredsequencialrequired

pncp_texto

Texto INTEIRO do edital em markdown (com marcadores '## Página N'), pra você RESUMIR ou ler o documento todo. Mantém o link de download do PDF no retorno. A partir de cnpj+ano+sequencial (referência da pncp_buscar). Editais muito grandes vêm truncados (use de_pagina/ate_pagina). Documento escaneado retorna aviso (OCR pendente).

Parametersanorequiredcnpjrequiredde_paginadocumentoate_paginasequencialrequired

pncp_contratos

Lista contratos públicos firmados num período, opcionalmente filtrando por órgão (CNPJ).

Parameterspaginacnpj_orgaodata_finalrequireddata_inicialrequiredtamanho_pagina

pncp_atas

Lista atas de registro de preços vigentes num período (referência de preços praticados pelo governo), opcionalmente por órgão (CNPJ).

Parameterscnpjpaginadata_finalrequireddata_inicialrequiredtamanho_pagina

pncp_pca

Plano anual de contratações (PCA) por ano e classificação superior do catálogo: o que os órgãos planejam contratar no ano.

Parameterspaginaano_pcarequiredtamanho_paginacodigo_classificacao_superiorrequired

pncp_historico

Arquivo histórico de licitações: consulta editais que a plataforma acumulou ao longo do tempo (inclusive os que já encerraram ou saíram do ar), por PALAVRA-CHAVE no objeto, estado (UF), modalidade, situação e período de publicação. Diferente da pncp_buscar (consulta ao vivo), aqui a base é o arquivo próprio, útil pra histórico e séries.

Parametersufatedesdetermopaginasituacaovalor_maxvalor_minmodalidadetam_pagina

pncp_orgaos

Busca de ÓRGÃOS/entidades compradoras por nome, UF e/ou portal. Devolve portal, UF, uasg, nome e info de pagamento. Útil pra achar o órgão e usar o filtro em outras buscas. Aceita VÁRIOS nomes em `termos[]`: cada um vira uma busca separada (disparadas com intervalo entre si pra não pegar rate limit), resultados fundidos e deduplicados. ATENÇÃO: termo muito amplo (ex.: 'prefeitura', 'ministerio') estoura a fonte, prefira UF/portal ou um nome específico. Com antecipagov=true, consulta a base do programa AntecipaGov.

Parametersuftermopaginatermosportaisantecipagov

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Parameterscontextmessagerequiredconversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Takes no parameters.

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Takes no parameters.

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.

Other Pncp integrations