Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Portal da Transparencia (BYOK) — connector documentation

  • MCP endpoint: https://byok-portal-transparencia.connectorbay.com/mcp
  • REST API: POST https://byok-portal-transparencia.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-portal-transparencia.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Portal da Transparencia Portal da Transparencia API key, sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-portal-transparencia.connectorbay.com/health · Tool schemas: https://byok-portal-transparencia.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-portal-transparencia · agent@connectorbay.com

What Portal da Transparencia (BYOK) is for

Portal da Transparencia (BYOK) lets an AI assistant read your own Portal da Transparencia data through the Portal da Transparencia API with a key you supply (Portal da Transparencia API key). Read-only: 12 tools (list_siafi_agencies, list_siape_agencies, search_contracts, get_contract, search_bids, get_bid, search_agreements, get_agreement, get_spending_by_agency, search_parliamentary_amendments, get_company, list_federal_properties). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.portaldatransparencia.gov.br. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Portal da Transparencia. Portal da Transparencia and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "What is the SIAFI code of the Ministry of Health?"
  • "Which SIAPE agencies have 'Educacao' in their name?"
  • "Which contracts does agency 26000 have?"
  • "Show federal contract 12345"
  • "Which bids did agency 26000 open in March 2026?"
  • "Show federal bid 54321"

What it does

  • list_siafi_agencies: List federal agencies registered in SIAFI with their codes, optionally filtered by code or name; the codes are needed by the contract, bid and spending tools. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • list_siape_agencies: List federal agencies registered in SIAPE (the civil-service payroll system) with their codes, optionally filtered by code or name. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • search_contracts: List federal executive contracts for one agency, optionally limited to contracts whose term falls in a date range. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • get_contract: Get one federal contract by its portal id. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • search_bids: List federal procurement bids (licitacoes) for one agency, optionally by opening date; the portal asks for a period of at most one month. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • get_bid: Get one federal procurement bid by its portal id. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • search_agreements: List federal agreements (convenios) with filters for reference dates, recipient, agency, state, municipality and status; the portal asks for a reference period of at most one day when dates are used. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • get_agreement: Get one federal agreement (convenio) by its portal id. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • get_spending_by_agency: Get federal spending per agency for a year, optionally for one top-level agency or one entity (SIAFI codes). The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • search_parliamentary_amendments: List federal budget amendments proposed by members of congress, filtered by year, author, amendment code or number, function and sub-function. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • get_company: Look up the portal's record of a legal entity (company or public body) by CNPJ number. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.
  • list_federal_properties: List federal real-estate properties filtered by managing agency, status, region, postcode or address text. The portal's documentation does not list response fields, so the full answer is returned (trimmed to fit); field names are in Portuguese.

BYOK key

You bring your own Portal da Transparencia Portal da Transparencia API key (https://portaldatransparencia.gov.br/api-de-dados/cadastrar-email). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.portaldatransparencia.gov.br over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Portal da Transparencia API (api.portaldatransparencia.gov.br) with a BYOK key; documentation: https://api.portaldatransparencia.gov.br/swagger-ui/index.html. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Portal da Transparencia. Portal da Transparencia and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Portal da Transparencia account.

Built for: Worldwide. Languages: English, Portuguese.