Skip to content

v0.1.1 — BrasilAPI fallback + Official MCP Registry

Choose a tag to compare

@laespina laespina released this 11 May 14:47
· 20 commits to main since this release

What changed

Added

  • BrasilAPI fallback for get_orgao — when PNCP returns 502/503/504 or times out, the tool now falls back to BrasilAPI's CNPJ endpoint and maps razao_social, nome_fantasia, natureza_juridica, descricao_situacao_cadastral, municipio, and uf into the Orgao schema. Fallback responses include a _source: "brasilapi-fallback" marker so clients can detect degraded mode.
  • mcpName: "io.github.Licinexus/mcp" in package.json — required by the Official MCP Registry for ownership verification. Registration submission follows.

Tests

  • 6 new unit tests cover the fallback paths (success, 502, 503, timeout, 404 non-fallback, fallback-also-fails). 44/44 total green.

Context

PNCP detail endpoints showed transient 502/503 errors during the v0.1.0 launch window (~40% failure rate over the previous 10 days). The fallback above keeps the most-used get_orgao tool working through PNCP backend incidents. Tools that have no public alternative still return isError: true with a structured error message instead of crashing.

Install

npx -y @licinexusbr/mcp@0.1.1

For Claude Desktop, no config change needed — npx -y @licinexusbr/mcp always picks up the latest published version.

Links