mcp-dir PNCP MCP
An MCP server that searches Brazilian government tenders and public procurement (PNCP). It allows agents to find notices and auctions by keyword, state, and modality, filter opportunities by value range, retrieve full procurement details with line items and prices, and access tender documents including PDF links and text.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.mcp.ai/p_pncpWhat its tools do
19 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (16)
Can change data (3)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- List electronic auctions published in SP in the last week
- Search for open 'school meal' notices
- Find who won a specific tender by CNPJ, year, and sequence
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- mcp-ai 0.9.409
- MCP protocol negotiated in check
- 2025-11-25
- Tools
- 19 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
19 advertised
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).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"tipo": {
"enum": [
"edital",
"ata",
"contrato"
],
"type": "string"
},
"termo": {
"type": "string"
},
"pagina": {
"type": "number"
},
"status": {
"type": "string"
},
"termos": {
"type": "array",
"items": {
"type": "string"
}
},
"ordenacao": {
"type": "string"
},
"tam_pagina": {
"type": "number"
}
}
}{
"title": "pncp_buscar",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"uf": {
"type": "string"
},
"cnpj": {
"type": "string"
},
"pagina": {
"type": "number"
},
"termos": {
"type": "array",
"items": {
"type": "string"
}
},
"expandir": {
"type": "boolean"
},
"municipio": {
"type": "string"
},
"ordenacao": {
"enum": [
"data",
"valor",
"prazo"
],
"type": "string"
},
"valor_max": {
"type": "number"
},
"valor_min": {
"type": "number"
},
"data_final": {
"type": "string"
},
"modalidade": {
"type": "number"
},
"data_inicial": {
"type": "string"
},
"incluir_valor": {
"type": "boolean"
},
"apenas_abertas": {
"type": "boolean"
},
"tamanho_pagina": {
"type": "number"
}
}
}{
"title": "pncp_listar",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"ufs": {
"type": "array",
"items": {
"type": "string"
}
},
"termo": {
"type": "string"
},
"pagina": {
"type": "number"
},
"termos": {
"type": "array",
"items": {
"type": "string"
}
},
"excluir": {
"type": "string"
},
"portais": {
"type": "array",
"items": {
"type": "string"
}
},
"expandir": {
"type": "boolean"
},
"tipo_item": {
"enum": [
"",
"MATERIAL",
"SERVICO"
],
"type": "string"
},
"valor_max": {
"type": "number"
},
"valor_min": {
"type": "number"
},
"data_final": {
"type": "string"
},
"modalidades": {
"type": "array",
"items": {
"type": "number"
}
},
"data_inicial": {
"type": "string"
},
"tipo_periodo": {
"enum": [
"abertura",
"publicacao",
"encerramento"
],
"type": "string"
},
"itens_desertos": {
"type": "boolean"
},
"pesquisa_ampla": {
"type": "boolean"
},
"somente_sigilosos": {
"type": "boolean"
},
"superoportunidades": {
"type": "boolean"
},
"excluir_registro_preco": {
"type": "boolean"
},
"participacao_exclusiva": {
"type": "boolean"
}
}
}{
"title": "pncp_oportunidades",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"id": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"ids": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
}
}{
"title": "pncp_processo",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cnpj",
"ano",
"sequencial"
],
"properties": {
"ano": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"cnpj": {
"type": "string"
},
"itens": {
"type": "boolean"
},
"resultado": {
"type": "boolean"
},
"sequencial": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
}{
"title": "pncp_detalhe",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cnpj",
"ano",
"sequencial"
],
"properties": {
"ano": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"cnpj": {
"type": "string"
},
"sequencial": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"numero_item": {
"type": "number"
}
}
}{
"title": "pncp_resultado",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cnpj",
"ano",
"sequencial"
],
"properties": {
"ano": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"cnpj": {
"type": "string"
},
"sequencial": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
}{
"title": "pncp_arquivos",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cnpj",
"ano",
"sequencial"
],
"properties": {
"ano": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"cnpj": {
"type": "string"
},
"de_pagina": {
"type": "number"
},
"documento": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
},
"ate_pagina": {
"type": "number"
},
"sequencial": {
"anyOf": [
{
"type": "string"
},
{
"type": "number"
}
]
}
}
}{
"title": "pncp_texto",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}pncp_contratos
Lista contratos públicos firmados num período, opcionalmente filtrando por órgão (CNPJ).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"data_inicial",
"data_final"
],
"properties": {
"pagina": {
"type": "number"
},
"cnpj_orgao": {
"type": "string"
},
"data_final": {
"type": "string"
},
"data_inicial": {
"type": "string"
},
"tamanho_pagina": {
"type": "number"
}
}
}{
"title": "pncp_contratos",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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).
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"data_inicial",
"data_final"
],
"properties": {
"cnpj": {
"type": "string"
},
"pagina": {
"type": "number"
},
"data_final": {
"type": "string"
},
"data_inicial": {
"type": "string"
},
"tamanho_pagina": {
"type": "number"
}
}
}{
"title": "pncp_atas",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ano_pca",
"codigo_classificacao_superior"
],
"properties": {
"pagina": {
"type": "number"
},
"ano_pca": {
"type": "number"
},
"tamanho_pagina": {
"type": "number"
},
"codigo_classificacao_superior": {
"type": "number"
}
}
}{
"title": "pncp_pca",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"uf": {
"type": "string"
},
"ate": {
"type": "string"
},
"desde": {
"type": "string"
},
"termo": {
"type": "string"
},
"pagina": {
"type": "number"
},
"situacao": {
"type": "string"
},
"valor_max": {
"type": "number"
},
"valor_min": {
"type": "number"
},
"modalidade": {
"type": "string"
},
"tam_pagina": {
"type": "number"
}
}
}{
"title": "pncp_historico",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"uf": {
"type": "string"
},
"termo": {
"type": "string"
},
"pagina": {
"type": "number"
},
"termos": {
"type": "array",
"items": {
"type": "string"
}
},
"portais": {
"type": "array",
"items": {
"type": "string"
}
},
"antecipagov": {
"type": "boolean"
}
}
}{
"title": "pncp_orgaos",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}show_version
Show the current MCP platform and adapter versions.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Show Version",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}report_bug
Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"message"
],
"properties": {
"context": {
"type": "string",
"default": ""
},
"message": {
"type": "string"
},
"conversation": {
"type": "string",
"default": "[]"
}
}
}{
"title": "Report Bug",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}connect
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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Connection Status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}{
"title": "Toolkit Info",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "number",
"default": 10
},
"query": {
"type": "string",
"default": ""
},
"action": {
"enum": [
"search",
"describe",
"install",
"uninstall",
"subscribe",
"cancel",
"resume",
"report_bug",
"request_mcp",
"list_tools",
"invoke",
"search_prompts",
"get_prompt",
"publish_prompt"
],
"type": "string",
"default": "search"
},
"mcp_id": {
"type": "string",
"default": ""
},
"message": {
"type": "string",
"default": ""
},
"tool_id": {
"type": "string",
"default": ""
},
"arguments": {
"type": "string",
"default": "{}"
},
"immediate": {
"type": "boolean",
"default": false
},
"tier_slug": {
"type": "string",
"default": ""
},
"prompt_body": {
"type": "string",
"default": ""
},
"prompt_slug": {
"type": "string",
"default": ""
},
"prompt_tool": {
"type": "string",
"default": ""
},
"prompt_vars": {
"type": "string",
"default": "{}"
},
"conversation": {
"type": "string",
"default": "[]"
},
"prompt_title": {
"type": "string",
"default": ""
},
"request_name": {
"type": "string",
"default": ""
},
"cancel_reason": {
"enum": [
"too_expensive",
"missing_features",
"switched_service",
"unused",
"customer_service",
"too_complex",
"low_quality",
"other"
],
"type": "string"
},
"cancel_comment": {
"type": "string",
"default": ""
},
"prompt_targets": {
"type": "array",
"items": {
"enum": [
"claude",
"chatgpt",
"cursor",
"lovable"
],
"type": "string"
},
"default": []
},
"report_context": {
"type": "string",
"default": ""
},
"prompt_category": {
"type": "string",
"default": ""
},
"request_details": {
"type": "string",
"default": ""
},
"prompt_description": {
"type": "string",
"default": ""
}
}
}{
"title": "Marketplace",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}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.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"token": {
"type": "string"
}
}
}{
"title": "Authenticate",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1627 ms
- 95th percentile latency
- 1627 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1627 ms · metadata changed · 19 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http pncp-mcp https://api.mcp.ai/p_pncpCodex
codex mcp add pncp-mcp --url https://api.mcp.ai/p_pncpCursor
{
"mcpServers": {
"pncp-mcp": {
"url": "https://api.mcp.ai/p_pncp"
}
}
}Cline
{
"mcpServers": {
"pncp-mcp": {
"type": "streamableHttp",
"url": "https://api.mcp.ai/p_pncp",
"disabled": false
}
}
}VS Code
{
"servers": {
"pncp-mcp": {
"type": "http",
"url": "https://api.mcp.ai/p_pncp"
}
}
}Gemini CLI
gemini mcp add --transport http pncp-mcp https://api.mcp.ai/p_pncpClaude Desktop
https://api.mcp.ai/p_pncpWindsurf
{
"mcpServers": {
"pncp-mcp": {
"serverUrl": "https://api.mcp.ai/p_pncp"
}
}
}Let your agent find its tools
Find servers like mcp-dir PNCP MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.