Global law
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
A catalog-driven gateway over Brazilian government APIs, loading OpenAPI specs on demand.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 4/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 16/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install gov.br APIs MCP. Follow https://mcp.popnx.com/i/thalisantunes-govbr-apis-mcp.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 14, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server gov.br APIs MCP for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "govbr-apis": { "command": "uvx", "args": [ "govbr-apis-mcp" ], "env": { "TRANSPARENCIA_API_KEY": "your-value", "DATAJUD_API_KEY": "your-value", "DADOSGOV_API_KEY": "your-value", "SERPRO_CPF_CLIENT_ID": "your-value", "SERPRO_CPF_CLIENT_SECRET": "your-value", "SERPRO_CNPJ_CLIENT_ID": "your-value", "SERPRO_CNPJ_CLIENT_SECRET": "your-value", "SERPRO_DATAVALID_CLIENT_ID": "your-value", "SERPRO_DATAVALID_CLIENT_SECRET": "your-value", "MEIAENTRADA_CODIGO_ACESSO": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the gov.br APIs MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
SettingsDeveloperEdit Config
{
"mcpServers": {
"govbr-apis": {
"command": "uvx",
"args": [
"govbr-apis-mcp"
],
"env": {
"TRANSPARENCIA_API_KEY": "your-value",
"DATAJUD_API_KEY": "your-value",
"DADOSGOV_API_KEY": "your-value",
"SERPRO_CPF_CLIENT_ID": "your-value",
"SERPRO_CPF_CLIENT_SECRET": "your-value",
"SERPRO_CNPJ_CLIENT_ID": "your-value",
"SERPRO_CNPJ_CLIENT_SECRET": "your-value",
"SERPRO_DATAVALID_CLIENT_ID": "your-value",
"SERPRO_DATAVALID_CLIENT_SECRET": "your-value",
"MEIAENTRADA_CODIGO_ACESSO": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use gov.br APIs MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using gov.br APIs MCP or shows a gov.br APIs MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
GOVBR_CATALOG_DIR Directory of catalog YAML files that replaces the packaged catalog (trusted input)GOVBR_EXTRA_CATALOG_DIR Directory of catalog YAML files whose entries are added to the catalog, overriding same-id onesGOVBR_EXTRA_ALLOWED_HOSTS Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent thereXDG_CACHE_HOME Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cacheDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect gov.br APIs MCP yet
gov.br APIs MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect gov.br APIs MCP
B · Others in Law & government data that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Works with Claude Code, with some setup first
You need a gov.br APIs MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server gov.br APIs MCP for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user govbr-apis --env TRANSPARENCIA_API_KEY=your-value --env DATAJUD_API_KEY=your-value --env DADOSGOV_API_KEY=your-value --env SERPRO_CPF_CLIENT_ID=your-value --env SERPRO_CPF_CLIENT_SECRET=your-value --env SERPRO_CNPJ_CLIENT_ID=your-value --env SERPRO_CNPJ_CLIENT_SECRET=your-value --env SERPRO_DATAVALID_CLIENT_ID=your-value --env SERPRO_DATAVALID_CLIENT_SECRET=your-value --env MEIAENTRADA_CODIGO_ACESSO=your-value -- uvx govbr-apis-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the gov.br APIs MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user govbr-apis --env TRANSPARENCIA_API_KEY=your-value --env DATAJUD_API_KEY=your-value --env DADOSGOV_API_KEY=your-value --env SERPRO_CPF_CLIENT_ID=your-value --env SERPRO_CPF_CLIENT_SECRET=your-value --env SERPRO_CNPJ_CLIENT_ID=your-value --env SERPRO_CNPJ_CLIENT_SECRET=your-value --env SERPRO_DATAVALID_CLIENT_ID=your-value --env SERPRO_DATAVALID_CLIENT_SECRET=your-value --env MEIAENTRADA_CODIGO_ACESSO=your-value -- uvx govbr-apis-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see gov.br APIs MCP listed as connected
Use gov.br APIs MCP and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using gov.br APIs MCP or shows a gov.br APIs MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
GOVBR_CATALOG_DIR Directory of catalog YAML files that replaces the packaged catalog (trusted input)GOVBR_EXTRA_CATALOG_DIR Directory of catalog YAML files whose entries are added to the catalog, overriding same-id onesGOVBR_EXTRA_ALLOWED_HOSTS Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent thereXDG_CACHE_HOME Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cacheDescriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a gov.br APIs MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server gov.br APIs MCP for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "govbr-apis": { "command": "uvx", "args": [ "govbr-apis-mcp" ], "env": { "TRANSPARENCIA_API_KEY": "your-value", "DATAJUD_API_KEY": "your-value", "DADOSGOV_API_KEY": "your-value", "SERPRO_CPF_CLIENT_ID": "your-value", "SERPRO_CPF_CLIENT_SECRET": "your-value", "SERPRO_CNPJ_CLIENT_ID": "your-value", "SERPRO_CNPJ_CLIENT_SECRET": "your-value", "SERPRO_DATAVALID_CLIENT_ID": "your-value", "SERPRO_DATAVALID_CLIENT_SECRET": "your-value", "MEIAENTRADA_CODIGO_ACESSO": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the gov.br APIs MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the gov.br APIs MCP settings, TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use gov.br APIs MCP and tell me what you can do for me, then show me one thing✓ If Cursor says it is using gov.br APIs MCP or shows a gov.br APIs MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
GOVBR_CATALOG_DIR Directory of catalog YAML files that replaces the packaged catalog (trusted input)GOVBR_EXTRA_CATALOG_DIR Directory of catalog YAML files whose entries are added to the catalog, overriding same-id onesGOVBR_EXTRA_ALLOWED_HOSTS Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent thereXDG_CACHE_HOME Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cacheDescriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a gov.br APIs MCP key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server gov.br APIs MCP for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "govbr-apis": { "type": "stdio", "command": "uvx", "args": [ "govbr-apis-mcp" ], "env": { "TRANSPARENCIA_API_KEY": "your-value", "DATAJUD_API_KEY": "your-value", "DADOSGOV_API_KEY": "your-value", "SERPRO_CPF_CLIENT_ID": "your-value", "SERPRO_CPF_CLIENT_SECRET": "your-value", "SERPRO_CNPJ_CLIENT_ID": "your-value", "SERPRO_CNPJ_CLIENT_SECRET": "your-value", "SERPRO_DATAVALID_CLIENT_ID": "your-value", "SERPRO_DATAVALID_CLIENT_SECRET": "your-value", "MEIAENTRADA_CODIGO_ACESSO": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the gov.br APIs MCP tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the gov.br APIs MCP settings, TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use gov.br APIs MCP and tell me what you can do for me, then show me one thing✓ If VS Code says it is using gov.br APIs MCP or shows a gov.br APIs MCP tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
GOVBR_CATALOG_DIR Directory of catalog YAML files that replaces the packaged catalog (trusted input)GOVBR_EXTRA_CATALOG_DIR Directory of catalog YAML files whose entries are added to the catalog, overriding same-id onesGOVBR_EXTRA_ALLOWED_HOSTS Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent thereXDG_CACHE_HOME Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cacheDescriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.
JSON settings are under “For developers” below
Claude Code
claude mcp add --scope user govbr-apis --env TRANSPARENCIA_API_KEY=your-value --env DATAJUD_API_KEY=your-value --env DADOSGOV_API_KEY=your-value --env SERPRO_CPF_CLIENT_ID=your-value --env SERPRO_CPF_CLIENT_SECRET=your-value --env SERPRO_CNPJ_CLIENT_ID=your-value --env SERPRO_CNPJ_CLIENT_SECRET=your-value --env SERPRO_DATAVALID_CLIENT_ID=your-value --env SERPRO_DATAVALID_CLIENT_SECRET=your-value --env MEIAENTRADA_CODIGO_ACESSO=your-value -- uvx govbr-apis-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"govbr-apis": {
"command": "uvx",
"args": [
"govbr-apis-mcp"
],
"env": {
"TRANSPARENCIA_API_KEY": "your-value",
"DATAJUD_API_KEY": "your-value",
"DADOSGOV_API_KEY": "your-value",
"SERPRO_CPF_CLIENT_ID": "your-value",
"SERPRO_CPF_CLIENT_SECRET": "your-value",
"SERPRO_CNPJ_CLIENT_ID": "your-value",
"SERPRO_CNPJ_CLIENT_SECRET": "your-value",
"SERPRO_DATAVALID_CLIENT_ID": "your-value",
"SERPRO_DATAVALID_CLIENT_SECRET": "your-value",
"MEIAENTRADA_CODIGO_ACESSO": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"govbr-apis": {
"command": "uvx",
"args": [
"govbr-apis-mcp"
],
"env": {
"TRANSPARENCIA_API_KEY": "your-value",
"DATAJUD_API_KEY": "your-value",
"DADOSGOV_API_KEY": "your-value",
"SERPRO_CPF_CLIENT_ID": "your-value",
"SERPRO_CPF_CLIENT_SECRET": "your-value",
"SERPRO_CNPJ_CLIENT_ID": "your-value",
"SERPRO_CNPJ_CLIENT_SECRET": "your-value",
"SERPRO_DATAVALID_CLIENT_ID": "your-value",
"SERPRO_DATAVALID_CLIENT_SECRET": "your-value",
"MEIAENTRADA_CODIGO_ACESSO": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"govbr-apis": {
"type": "stdio",
"command": "uvx",
"args": [
"govbr-apis-mcp"
],
"env": {
"TRANSPARENCIA_API_KEY": "your-value",
"DATAJUD_API_KEY": "your-value",
"DADOSGOV_API_KEY": "your-value",
"SERPRO_CPF_CLIENT_ID": "your-value",
"SERPRO_CPF_CLIENT_SECRET": "your-value",
"SERPRO_CNPJ_CLIENT_ID": "your-value",
"SERPRO_CNPJ_CLIENT_SECRET": "your-value",
"SERPRO_DATAVALID_CLIENT_ID": "your-value",
"SERPRO_DATAVALID_CLIENT_SECRET": "your-value",
"MEIAENTRADA_CODIGO_ACESSO": "your-value"
}
}
}
}TRANSPARENCIA_API_KEY secret required envDATAJUD_API_KEY secret required envDADOSGOV_API_KEY secret required envSERPRO_CPF_CLIENT_ID secret required envSERPRO_CPF_CLIENT_SECRET secret required envSERPRO_CNPJ_CLIENT_ID secret required envSERPRO_CNPJ_CLIENT_SECRET secret required envSERPRO_DATAVALID_CLIENT_ID secret required envSERPRO_DATAVALID_CLIENT_SECRET secret required envMEIAENTRADA_CODIGO_ACESSO secret required envGOVBR_CATALOG_DIR envGOVBR_EXTRA_CATALOG_DIR envGOVBR_EXTRA_ALLOWED_HOSTS envXDG_CACHE_HOME envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026
The registry name was verified with the GitHub account thalisantunes, which owns the repo
Code last changed 6 days ago
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
No entries on OSV.dev for govbr-apis-mcp@0.2.0
Checks only this package version, not every dependency · checked Nov 15, 2026
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/thalisantunes-govbr-apis-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed 6 days ago, and the latest version (0.2.0) reached the registry 30 days ago.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
The law of nearly every country on earth, any date: read it, see what changed it, check citations.
German court decisions (Rechtsprechung) and laws (Gesetze) with citation graph and citation checks.
Search French-language and European case law and French legal texts (codes, statutes, treaties).
Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.
Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.
| This one gov.br APIs MCP | Global law | Open Legal Data (Germany) | LibreJustice | InfraNode | Fedlex Connector | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | No | No |
| Basic checks | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| License | MIT | NOASSERTION | MIT | Apache-2.0 | Apache-2.0 | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
MCP server that turns Brazilian government APIs into Claude-callable tools through a catalog-driven gateway: instead of one tool per endpoint (hundreds — would blow up client context), five generic tools operate over a local YAML catalog of 116 APIs.
Only the entries that declare an openapi_url have a spec to load: today the Câmara dos Deputados and the Portal da Transparência, 2 of the 116. For those, describe_api loads the OpenAPI spec on demand. Every other callable entry (see the "Callable today?" column below) is reached through call_api alone, using the endpoints in its description and docs_url.
| Tier | File | Access model | Callable today? |
|---|---|---|---|
public | src/govbr_apis_mcp/catalog_data/public.yaml | Free — no auth or free API key (IBGE, Banco Central, Câmara, Senado, Portal da Transparência, DataJud, Ipeadata, dados.gov.br…) | Yes |
serpro | src/govbr_apis_mcp/catalog_data/serpro.yaml | Serpro commercial (loja.serpro.gov.br) — OAuth2 client credentials per contracted API, paid per call | With a Serpro contract: set the SERPRO_* variables |
meia-entrada | src/govbr_apis_mcp/catalog_data/meia_entrada.yaml | Eligibility sources for half-price tickets (student CIE, ID Jovem, PcD, e-MEC) — see docs/meia-entrada.md and the POC | CIE yes (DNE and FESN); the rest is manual |
conecta | src/govbr_apis_mcp/catalog_data/conecta.yaml | Conecta gov.br — restricted to public-sector entities; 95 APIs indexed as stubs for discovery | Not yet (adhesion pending) |
The Conecta tier exists so the catalog reflects the whole landscape now, and becomes callable later by filling in base_url + credentials — the OAuth2 client-credentials flow is already implemented (Serpro uses the same one).
search_catalog(query, category?) — accent-insensitive keyword search; reports total matches and whether the list was truncated.list_apis(category?, status?, limit?) — enumerate entries, callable ones first (by the catalog's status, not by whether your credentials are set; filter it: ~95 Conecta stubs otherwise dominate the output).describe_api(api_id, path?, method?) — catalog metadata + OpenAPI operation list; with path, parameter/request/response schemas ($refs inlined, depth-limited). Reads OpenAPI 3 and Swagger 2.0, as JSON or YAML.call_api(api_id, path, method?, query?, body?, headers?) — invoke an endpoint; base URL and auth resolved from the catalog entry.method is GET, HEAD, POST, PUT, PATCH, DELETE or OPTIONS; anything else returns an error with allowed_methods. A body is accepted only with POST, PUT and PATCH.path is relative to the base_url. . and .. segments (after up to three rounds of percent-decoding, with \ read as / and ; parameters removed) and any path that leaves the base_url prefix are rejected. So is a # (a fragment is never sent; write a literal one as %23) or a control character.path is merged with query; a key in query replaces the embedded one, and a list value repeats the key._ equal to -. Authorization, Proxy-Authorization, Host, Cookie and Accept-Encoding, plus connection, proxy, forwarding and method-override headers, are dropped and reported in ignored_headers (the full list is in server.py). The managed credential is applied last and always wins. A header with an invalid name or value is not ignored: it fails the call with an error.{"error": ...}.3xx is not followed: the response carries its location (redacted, resolved against the requested URL). Response bodies are cut at 60,000 characters.credentials_status(api_id?) — which env vars each API needs and whether they're set, plus callable: whether call_api would accept the entry right now (available and unstable entries; requires_contract ones only once their env vars are set).Fluxo funcional ponta a ponta (código da CIE → decisão de elegibilidade), incluindo modo demo sem credencial: poc/README.md.
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]' .venv/bin/pytest
Register in Claude Code (.mcp.json or claude mcp add):
{
"mcpServers": { "govbr-apis": { "command": "/path/to/govbr-apis-mcp/.venv/bin/govbr-apis-mcp", "env": { "TRANSPARENCIA_API_KEY": "...", "DATAJUD_API_KEY": "..." } } } }
From PyPI: uvx govbr-apis-mcp (set "command": "uvx" and "args": ["govbr-apis-mcp"] in the entry above; no checkout needed). Each release is published to PyPI and to the MCP Registry automatically (publish.yml).
Or run it in a container. The server speaks stdio, so keep -i:
docker build -t govbr-apis-mcp . && docker run -i --rm -e TRANSPARENCIA_API_KEY=... govbr-apis-mcp
All secrets come from env vars declared per entry in the catalog (auth_config). Nothing is stored in the repo. .env.example lists the variables. Entries with a free key carry a signup_url; Serpro credentials come with the contract, at loja.serpro.gov.br. credentials_status reports readiness.
The server does not read .env files, and MCP clients start it with a minimal environment, so an export in your shell may never reach it. Put the variables in the client's env block (the example above, or claude mcp add -e KEY=value). For a container, copy .env.example to a git-ignored file such as .env.local, fill in the copy and pass it with docker run --env-file .env.local. Never put real values in .env.example: it is versioned.
API keys (the value together with any prefix) are stripped of surrounding whitespace and must be printable ASCII; otherwise the call fails with credential in contains invalid characters, without echoing the value. OAuth2 client ids and secrets are only stripped: they travel base64-encoded, so any text works. The access token the endpoint returns must be printable ASCII too. When the token endpoint fails, the call returns an error and the token_url, with neither the response body nor any secret.
Auth profiles: none, api_key (static header, optional value prefix — e.g. DataJud's APIKey ), oauth2_client_credentials (token endpoint + id/secret, in-memory token cache; used by Serpro today, by Conecta after adhesion).
Add an entry to a YAML file in src/govbr_apis_mcp/catalog_data/. The directory is package data, so the wheel, uvx and the Docker image all carry the catalog. Minimum fields: id, name, provider, category, status, auth. Add openapi_url when the API publishes a spec — describe_api then works with zero code. Regenerate the Conecta tier with .venv/bin/python scripts/scrape_conecta.py. It leaves the file alone when the page yields no APIs, an id the catalog would reject, or fewer than half the current entries (--force overrides only the last check).
Entries are validated on load: ids must be filename-safe, URLs must be https on an allowlisted host (*.gov.br, *.leg.br, *.jus.br plus a few named hosts), and a hostname may only contain [a-z0-9.-] (write internationalized names in punycode). This is a security boundary, not style — the catalog decides where your credentials are sent. Add a host with GOVBR_EXTRA_ALLOWED_HOSTS only if you trust it with them; the same hostname rule applies to it.
To override entries without forking (e.g. filling in Conecta base URLs after adhesion), point GOVBR_EXTRA_CATALOG_DIR at a directory of .yaml or .yml files whose same-id entries win. A directory that does not exist or holds no entries is an error, and so is an id repeated inside it; an empty value counts as unset. GOVBR_CATALOG_DIR replaces the base catalog entirely and should be treated as trusted input.
python3 -m venv .venv
.venv/bin/pip install -e '.[dev]' .venv/bin/ruff check . .venv/bin/ruff format --check . .venv/bin/pytest
CI runs ruff on Python 3.12 and the test suite on 3.11–3.14, then builds the wheel and loads the catalog from a clean install.
$XDG_CACHE_HOME/govbr-apis-mcp/ (or ~/.cache/govbr-apis-mcp/) for 24 hours, under a file name derived from sha256(api_id + "\n" + openapi_url): never the id itself, and a changed openapi_url never serves the old spec. OAuth2 tokens live in memory only.call_api does not follow redirects — credentialed requests cannot be steered to another host by a 3xx; the response carries the (redacted) location instead. It always sends Accept-Encoding: identity, so a server has no reason to compress. The 60,000-character cut counts decoded text, though: a server that compresses anyway can still inflate a small chunk before the cut (an accepted risk; see the roadmap).Location) must be https on an allowlisted host before it is requested. The body is capped at 5 MiB, JSON and YAML are accepted (YAML with aliases, including merge keys that rely on them, is refused), and the document must carry openapi or swagger. A compressed response is refused and the whole download has a 60-second deadline; both come back as spec_error.httpx and httpcore loggers stay at WARNING, so httpx logs no request URL (query string included).pii: true return personal data (CPF, name, photo) into the client transcript. Today: meiaentrada-cie-validador, fesn-cie-validador (callable without any credential: whoever holds a use code gets the holder's data) and the three Serpro entries.-trial base URLs with the published demo token)conecta-id-jovem (admite instituição privada)MIT - see LICENSE.