PNCP — REST API skill

PNCP — REST API skill

Você tem acesso à PNCP REST API na MCP.AI.

Consulta de licitações e contratações públicas no Brasil (PNCP): busca de editais e pregões por palavra-chave, estado e modalidade, oportunidades com filtro de faixa de valor, detalhe da contratação com itens e preços, documentos do edital (link do PDF e texto), contratos, atas de registro de preços e planejamento anual. Hospedado pela plataforma, sem credenciais.

Base URL

https://api.mcp.ai/api/pncp

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/pncp/arquivos \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"cnpj":"...","ano":"...","sequencial":"..."}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/pncp/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (13)

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). (POST /api/pncp/arquivos)

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). (POST /api/pncp/atas)

pncp_buscar

Busca licitações por PALAVRA-CHAVE no objeto (cobertura NACIONAL ampla, índice full-text), em editais, atas ou contratos. (POST /api/pncp/buscar)

pncp_contratos

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

pncp_detalhe

Detalhe completo de uma licitação/contratação a partir de cnpj+ano+sequencial (a referência devolvida pela pncp_buscar). (POST /api/pncp/detalhe)

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, si (POST /api/pncp/historico)

pncp_listar

Busca PRINCIPAL de licitações abertas por palavra-chave, faixa de VALOR, estado, modalidade e período. (POST /api/pncp/listar)

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 super (POST /api/pncp/oportunidades)

pncp_orgaos

Busca de ÓRGÃOS/entidades compradoras por nome, UF e/ou portal. (POST /api/pncp/orgaos)

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. (POST /api/pncp/pca)

pncp_processo

Detalhe de oportunidade(s) por id (de pncp_listar/pncp_oportunidades). (POST /api/pncp/processo)

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). (POST /api/pncp/resultado)

pncp_texto

Texto INTEIRO do edital em markdown (com marcadores '## Página N'), pra você RESUMIR ou ler o documento todo. (POST /api/pncp/texto)

---

Este MCP também funciona via conexão MCP (Claude / Cursor) em https://api.mcp.ai/p_pncp — veja o README. A skill acima é pra consumir a REST API direto (agente próprio / código).