Skip to main content
Glama
Sign In

PNCP

by io.github.mcp-dir
OverviewDiscussionsAdmin

pncp_texto

Read-onlyIdempotent

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).

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "cnpj": "<cnpj>",
      "ano": "<ano>",
      "sequencial": "<sequencial>"
    },
    "name": "pncp_texto"
  }
}

Input Schema

NameRequiredDescriptionDefault
anoYes
cnpjYes
de_paginaNo
documentoNo
ate_paginaNo
sequencialYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A5/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond annotations (read-only, idempotent), the description discloses key behaviors: returns markdown with page markers, preserves PDF download link, truncation for large texts, and OCR pending warnings for scanned documents. This adds significant transparency about the tool's runtime behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise, with the main purpose stated up front, followed by important usage notes. It is well-structured and free of fluff, conveying all necessary information in a few sentences.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the minimal schema (no parameter descriptions, no output schema) and the annotations (read-only, idempotent), the description covers all essential aspects: what it returns, how to identify the resource, pagination handling, and special cases like OCR. It is complete for effective use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description explains the meaning of the required parameters (cnpj, ano, sequencial) as a reference from pncp_buscar, and clarifies the optional page-range parameters (de_pagina/ate_pagina) for pagination. Since the schema has no descriptions, this provides essential semantic context that the raw schema lacks.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: returns the full text of an edital in markdown format, distinguishing it from sibling tools like pncp_buscar or pncp_detalhe. It specifies the action (read/summarize) and the resource (full document).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides explicit usage context: the identifiers (cnpj+ano+sequencial) come from pncp_buscar, and it explains when to use pagination (de_pagina/ate_pagina) for large documents, plus the OCR warning for scanned files. This clearly guides when to invoke this tool vs alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All PNCP toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources