# Licinexus MCP [Health: Active] **Category:** 💰 Finance & Fintech **Repository:** https://github.com/Licinexus/licinexus-mcp **GitHub Stars:** 78 **npm Downloads (last month):** 389 **Views:** 4 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/mcp-199 ## Description Brazilian public procurement (PNCP) and Federal Revenue CNPJ data — 16 tools, 4 prompts. ## Tools Capabilities this server exposes over MCP: - **search_licitacoes** — Search Brazilian public procurement bids (licitações) on PNCP. PNCP requires a date range and at least one modality code per query. If you do not specify, defaults are: last 7 days and modalities [6, 8, 9] (Pregão Eletrônico, Dispensa, Inexigibilidade — most common). Maximum date range per query: 365 days (PNCP limit). Wider windows return HTTP 422. For multi-year searches, issue multiple calls with date windows of <= 365 days each. Modality codes: 1 = Leilão - Eletrônico 2 = Diálogo Competitivo 3 = Concurso 4 = Concorrência - Eletrônica 5 = Concorrência - Presencial 6 = Pregão - Eletrônico 7 = Pregão - Presencial 8 = Dispensa de Licitação 9 = Inexigibilidade 10 = Manifestação de Interesse 11 = Pré-qualificação 12 = Credenciamento 13 = Leilão - Presencial Filters palavraChave, valorMinimo, valorMaximo are applied client-side over the page returned by PNCP. - **get_licitacao** — Get the full details of a single licitação (procurement bid) on PNCP. Provide either numeroControlePNCP (the full PNCP control number string) or all three of orgaoCnpj, ano, sequencial. - **list_licitacao_itens** — List the items (lots) of a licitação on PNCP. Each item has description, quantity, unit, estimated unit value and category. Provide either numeroControlePNCP, or orgaoCnpj/ano/sequencial. - **list_licitacao_resultados** — List the bidding results (winners, runners-up, prices, suppliers) for a specific item of a licitação. You must specify which item — use list_licitacao_itens first to discover item numbers. - **list_licitacao_arquivos** — List the files (edital PDFs, attachments, terms of reference) attached to a licitação on PNCP. Returns metadata and direct URLs — does not download the file content. - **search_contratos** — Search public procurement contracts (contratos) on PNCP. Useful for analyzing market history, supplier behavior, and agency spending patterns. Defaults to last 30 days when no date range is provided. Maximum date range per query: 365 days (PNCP limit); wider windows return HTTP 422. For multi-year searches, issue multiple calls. - **get_contrato** — Get the full details of a public contract on PNCP. Provide either numeroControlePNCP or orgaoCnpj/ano/sequencial. - **list_contrato_termos** — List the additive terms (termos aditivos) of a contract — extensions, value increases/reductions, term changes. Useful to understand contract evolution. - **list_contrato_instrumentos** — List billing instruments (NFes, faturas) attached to a contract. Reveals real execution: when payments were due, NFe keys, etc. - **search_atas_rp** — Search Atas de Registro de Preço (price-registry agreements) on PNCP. ARPs are pre-negotiated agreements that any compatible agency can use within the validity period — finding ones still in vigor with available balance is a key business opportunity. Defaults: last 90 days, only active (somenteVigentes=true). Maximum date range per query: 365 days (PNCP limit); wider windows return HTTP 422. - **get_ata_rp** — Get the full details of an Ata de Registro de Preço, optionally including its items (with available balance and supplier info) and attached files. Use orgaoCnpj/anoCompra/sequencialCompra (the parent procurement) and sequencialAta (the ARP within that procurement). - **get_orgao** — Get a public agency's profile from PNCP: legal name, branch of government (poder), federal/state/municipal level (esfera), legal nature, address. - **get_fornecedor_contratos** — List public contracts where a given CNPJ appears as the supplier (fornecedor). Useful for analyzing a competitor or a potential partner. Defaults to the last 365 days. - **search_pca** — Search recently published/updated Plano de Contratação Anual (PCA) entries — what public agencies INTEND to buy. Returns PCA entries (one per agency unit) with their items embedded. Filter by classification: 'material' or 'servico'. Defaults: last 30 days, classification 'material'. Per Lei 14.133. Maximum date range per query: 365 days (PNCP limit). - **list_pca_itens** — List the planned items of a specific PCA: descriptions, estimated quantities, unit values, expected delivery dates, and CATSER/CATMAT classification. Optionally filter client-side by keyword on description. - **get_cnpj_data** — Get a Brazilian company's public registration data: legal name, trade name, primary CNAE, secondary CNAEs, address, partners (QSA), capital, juridical nature, Simples/MEI status. Source: BrasilAPI by default (free aggregator over Receita Federal Open Data). Set CNPJ_PROVIDER=minhareceita to switch. - **aggregate_licitacoes_por_periodo** — Aggregate Brazilian public procurement bid counts (and optional value sums) over a time series — answers "how did volumes evolve month by month" without paginating tens of thousands of records. Each bucket is computed by issuing a single PNCP `list` call per (bucket × modality) and reading `totalRegistros` from the response. With default modalities (Pregão Eletrônico + Dispensa + Inexigibilidade) and granularidade=mes, a 12-month range = 36 calls. When `esfera` filter or value metrics are requested, the tool paginates the bucket internally (up to 50 pages = 2500 records per bucket) and aggregates client-side. Be conservative with date range × granularity in that mode. Maximum total date range: 1830 days (~5 years). Each bucket call respects the PNCP 365-day-per-call limit. Modality codes: 1 = Leilão - Eletrônico 2 = Diálogo Competitivo 3 = Concurso 4 = Concorrência - Eletrônica 5 = Concorrência - Presencial 6 = Pregão - Eletrônico 7 = Pregão - Presencial 8 = Dispensa de Licitação 9 = Inexigibilidade 10 = Manifestação de Interesse 11 = Pré-qualificação 12 = Credenciamento 13 = Leilão - Presencial Default modalities: [6, 8, 9] (Pregão Eletrônico, Dispensa, Inexigibilidade). - **compare_periodos** — Compare two date ranges side-by-side over the same filters — answers questions like "did Jun/2024 (electoral year) differ from Jun/2025 in bid volumes?". Wraps two `aggregate_licitacoes_por_periodo` calls and returns each period's total metrics plus absolute and percentage deltas. Use granularidade-style buckets implicitly = "ano" for the comparison (one bucket per period, summed). When `esfera` filter or value metrics are requested, the underlying tool paginates internally — be conservative with range size. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "licinexus-mcp": { "command": "npx", "args": ["-y","@licinexusbr/mcp"] } } ``` ## Documentation ## What Licinexus MCP MCP server does Licinexus MCP MCP server gives compatible AI clients structured access to Brazilian public procurement data from the Portal Nacional de Contratações Públicas (PNCP) and public company-registration data. It is suited to questions about open bids, contract history, winning suppliers, price-registration agreements, agency profiles, and what government bodies plan to buy. The procurement tools cover searches and record-level lookups. An agent can find licitações, retrieve a complete procurement record, inspect its items, review results for a selected item, and list attached file metadata with direct URLs. Contract tools expose contract details, additive terms, and billing instruments. Supplier-oriented queries can list contracts associated with a CNPJ, while CNPJ lookup returns registration details such as legal and trade names, CNAE classifications, address, partners, capital, juridical nature, and Simples or MEI status. ## How it works The server is stdio-based. An MCP client starts the npm package and communicates with it through JSON-RPC over standard input and output; it is not intended to be run as an interactive terminal command. Requests are sent to public data endpoints, so no local database or API credential is needed. PNCP searches require dates and, for licitações, at least one modality code. Defaults are provided when these values are omitted: recent searches generally use the last seven days and modalities 6, 8, and 9, while contract, price-registry, and PCA searches have their own documented default windows. PNCP accepts at most 365 days per request. Longer investigations must be split into separate windows. Keyword and value filters on some search operations are applied to the page returned by PNCP rather than across the entire result set. Aggregation tools summarize procurement counts and optional values by period, and a comparison tool returns totals and absolute or percentage differences for two periods. Aggregation can make additional requests when filtering by government sphere or calculating value metrics, so large ranges and fine-grained buckets may require care. ## Setup and configuration Licinexus MCP MCP server requires Node.js 18 or later and an MCP-compatible client. The package is available as `@licinexusbr/mcp` and can be launched with `npx -y @licinexusbr/mcp`. Add that command and its arguments to the client’s MCP configuration, then fully restart the client so it loads the server. The documented clients include Claude Desktop, Cursor, Continue, Cline, and programmatic MCP clients. ChatGPT consumer web does not natively support stdio MCP according to the supplied documentation, although an OpenAI Agents SDK setup is shown for programmatic use. No API key, registration, or local database is required. CNPJ data uses BrasilAPI by default; setting `CNPJ_PROVIDER=minhareceita` switches the provider to Minha Receita. ## Tools and capabilities - Search licitações, contratos, atas de registro de preço, and PCA entries. - Retrieve procurement, contract, price-registry, agency, and CNPJ details. - Inspect procurement items, results, files, contract terms, and billing instruments. - Find contracts associated with a supplier CNPJ. - Aggregate procurement activity over time and compare two periods. - Filter PCA entries by material or service classification and inspect planned items. ## Limitations and notes The server exposes metadata and direct URLs for licitação attachments; it does not download file contents. To inspect bidding results, the caller must first identify an item, normally by using the procurement-items tool. Price-registry lookups can include item balances and supplier information when the required procurement and registry identifiers are supplied. PNCP enforces the 365-day request limit and returns HTTP 422 for wider individual windows. The aggregation tool supports a maximum overall range of about five years, but each underlying request still follows the PNCP limit. Client-side filters may only apply to the page fetched for a search, and aggregation with pagination can issue many upstream calls. These constraints should be reflected in agent prompts and workflows. The project is open source under the MIT license. It is intended for MCP clients that can launch local stdio servers; a hosted remote endpoint is not described in the supplied material. _Full upstream README: https://allmcps.com/mcp/mcp-199/readme_