Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

gov.br APIs MCP

de thalisantunesversión 0.2.0i★ 1iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.thalisantunes/govbr-apis-mcp

Cómo instalar

What it does

A catalog-driven gateway over Brazilian government APIs, loading OpenAPI specs on demand.

  • Connects Se ejecuta en tu computadora
  • Account or key Needs 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
  • Category Derecho y datos públicos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad4/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso16/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala gov.br APIs MCP. Sigue https://mcp.popnx.com/i/thalisantunes-govbr-apis-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de gov.br APIs MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server gov.br APIs MCP para Claude en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por 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) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En 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 deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de gov.br APIs MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Regístrate y crea una clave de gov.br APIs MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  4. Pega esta configuración y guarda el archivo

    {
      "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"
          }
        }
      }
    }

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Cierra Claude y vuelve a abrirlo

  6. Pruébalo

    Usa gov.br APIs MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando gov.br APIs MCP o muestra una herramienta de gov.br APIs MCP en la respuesta, ya está conectado

4 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • GOVBR_CATALOG_DIR Directorio de archivos YAML de catálogo que reemplaza el catálogo incluido en el paquete (entrada de confianza).
    Ver original en inglésDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR Directorio de archivos YAML de catálogo cuyas entradas se añaden al catálogo, sustituyendo las de igual id.
    Ver original en inglésDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS Lista de nombres de host adicionales separados por comas que las URL de catálogo pueden usar; añada uno solo si confía en él con las credenciales enviadas allí
    Ver original en inglésComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME Directorio base de la caché de especificaciones OpenAPI (dentro de él se crea una carpeta govbr-apis-mcp); el valor predeterminado es /.cache
    Ver original en inglésBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar gov.br APIs MCP

gov.br APIs MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar gov.br APIs MCP

  • Necesitas una clave de gov.br APIs MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de gov.br APIs MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
  • Necesitas una clave de gov.br APIs MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
  • Necesitas una clave de gov.br APIs MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Derecho y datos públicos que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de gov.br APIs MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server gov.br APIs MCP para Claude Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por 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) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En 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 deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de gov.br APIs MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Regístrate y crea una clave de gov.br APIs MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  4. Pega este comando y pulsa Enter

    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

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Escribe /mcp en Claude Code

    Deberías ver gov.br APIs MCP en la lista como conectado

  6. Pruébalo

    Usa gov.br APIs MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando gov.br APIs MCP o muestra una herramienta de gov.br APIs MCP en la respuesta, ya está conectado

4 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • GOVBR_CATALOG_DIR Directorio de archivos YAML de catálogo que reemplaza el catálogo incluido en el paquete (entrada de confianza).
    Ver original en inglésDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR Directorio de archivos YAML de catálogo cuyas entradas se añaden al catálogo, sustituyendo las de igual id.
    Ver original en inglésDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS Lista de nombres de host adicionales separados por comas que las URL de catálogo pueden usar; añada uno solo si confía en él con las credenciales enviadas allí
    Ver original en inglésComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME Directorio base de la caché de especificaciones OpenAPI (dentro de él se crea una carpeta govbr-apis-mcp); el valor predeterminado es /.cache
    Ver original en inglésBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de gov.br APIs MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server gov.br APIs MCP para Cursor en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por 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) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En 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 deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de gov.br APIs MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Regístrate y crea una clave de gov.br APIs MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de gov.br APIs MCP, 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 está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de Cursor en modo Agent

  6. Pruébalo

    Usa gov.br APIs MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando gov.br APIs MCP o muestra una herramienta de gov.br APIs MCP en la respuesta, ya está conectado

4 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • GOVBR_CATALOG_DIR Directorio de archivos YAML de catálogo que reemplaza el catálogo incluido en el paquete (entrada de confianza).
    Ver original en inglésDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR Directorio de archivos YAML de catálogo cuyas entradas se añaden al catálogo, sustituyendo las de igual id.
    Ver original en inglésDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS Lista de nombres de host adicionales separados por comas que las URL de catálogo pueden usar; añada uno solo si confía en él con las credenciales enviadas allí
    Ver original en inglésComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME Directorio base de la caché de especificaciones OpenAPI (dentro de él se crea una carpeta govbr-apis-mcp); el valor predeterminado es /.cache
    Ver original en inglésBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de gov.br APIs MCP (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server gov.br APIs MCP para VS Code en este equipo, en este orden: 1) Comprueba uv con uv --version. Si falta, dime que lo instale desde https://docs.astral.sh/uv/getting-started/installation/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por 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) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En 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 deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de gov.br APIs MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala uv (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    uv --version
    • Aparece un número de versión, p. ej. uv … = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: uv no tiene instalador de clics. Copia el comando de una línea para tu sistema (macOS o Windows) desde la página oficial de uv y pégalo en la Terminal · no hace falta instalar Python aparte; uv lo descarga cuando lo necesita

    Abrir la página de descarga de uv ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: uv --version

    Se instala una vez y sirve para todo lo que usa uv

  2. Regístrate y crea una clave de gov.br APIs MCP

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de gov.br APIs MCP, 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 está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de VS Code en modo Agent

  6. Pruébalo

    Usa gov.br APIs MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando gov.br APIs MCP o muestra una herramienta de gov.br APIs MCP en la respuesta, ya está conectado

4 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • GOVBR_CATALOG_DIR Directorio de archivos YAML de catálogo que reemplaza el catálogo incluido en el paquete (entrada de confianza).
    Ver original en inglésDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR Directorio de archivos YAML de catálogo cuyas entradas se añaden al catálogo, sustituyendo las de igual id.
    Ver original en inglésDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS Lista de nombres de host adicionales separados por comas que las URL de catálogo pueden usar; añada uno solo si confía en él con las credenciales enviadas allí
    Ver original en inglésComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME Directorio base de la caché de especificaciones OpenAPI (dentro de él se crea una carpeta govbr-apis-mcp); el valor predeterminado es /.cache
    Ver original en inglésBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa gov.br APIs MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

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-mcp

Claude 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"
      }
    }
  }
}

Valores que debes completar

  • TRANSPARENCIA_API_KEY secreto obligatorio env
    Clave de API para la API de Portal da Transparencia.
    Ver original en inglésAPI key for the Portal da Transparencia API
  • DATAJUD_API_KEY secreto obligatorio env
    Clave de API para la API de CNJ DataJud.
    Ver original en inglésAPI key for the CNJ DataJud API
  • DADOSGOV_API_KEY secreto obligatorio env
    Clave API para la API del portal dados.gov.br (gratuita, se genera en el perfil de usuario).
    Ver original en inglésAPI key for the dados.gov.br portal API (free, generated in the user profile)
  • SERPRO_CPF_CLIENT_ID secreto obligatorio env
    ID de cliente OAuth2 para la API Serpro CPF (contrato comercial)
    Ver original en inglésOAuth2 client ID for the Serpro CPF API (commercial contract)
  • SERPRO_CPF_CLIENT_SECRET secreto obligatorio env
    Secreto de cliente OAuth2 para la API CPF de Serpro (contrato comercial).
    Ver original en inglésOAuth2 client secret for the Serpro CPF API (commercial contract)
  • SERPRO_CNPJ_CLIENT_ID secreto obligatorio env
    ID de cliente OAuth2 para la API Serpro CNPJ (contrato comercial)
    Ver original en inglésOAuth2 client ID for the Serpro CNPJ API (commercial contract)
  • SERPRO_CNPJ_CLIENT_SECRET secreto obligatorio env
    Secreto de cliente OAuth2 para la API CNPJ de Serpro (contrato comercial).
    Ver original en inglésOAuth2 client secret for the Serpro CNPJ API (commercial contract)
  • SERPRO_DATAVALID_CLIENT_ID secreto obligatorio env
    ID de cliente OAuth2 para la API Serpro Datavalid (contrato comercial)
    Ver original en inglésOAuth2 client ID for the Serpro Datavalid API (commercial contract)
  • SERPRO_DATAVALID_CLIENT_SECRET secreto obligatorio env
    Secreto de cliente OAuth2 para la API Datavalid de Serpro (contrato comercial).
    Ver original en inglésOAuth2 client secret for the Serpro Datavalid API (commercial contract)
  • MEIAENTRADA_CODIGO_ACESSO secreto obligatorio env
    Código de acceso (codigoAcesso) para el validador CIE usado en meia-entrada, emitido al local o productor
    Ver original en inglésAccess code (codigoAcesso) for the CIE validator used for meia-entrada, issued to the venue or producer
  • GOVBR_CATALOG_DIR env
    Directorio de archivos YAML de catálogo que reemplaza el catálogo incluido en el paquete (entrada de confianza).
    Ver original en inglésDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR env
    Directorio de archivos YAML de catálogo cuyas entradas se añaden al catálogo, sustituyendo las de igual id.
    Ver original en inglésDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS env
    Lista de nombres de host adicionales separados por comas que las URL de catálogo pueden usar; añada uno solo si confía en él con las credenciales enviadas allí
    Ver original en inglésComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME env
    Directorio base de la caché de especificaciones OpenAPI (dentro de él se crea una carpeta govbr-apis-mcp); el valor predeterminado es /.cache
    Ver original en inglésBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
23/sem
Conexión
Se ejecuta en tu computadora
Última versióni
0.2.0
Publicado en el registroi
20 oct 2026
Último cambio de códigoi
13 nov 2026
Creador
thalisantunes
Paquetes
pypi: govbr-apis-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub thalisantunes, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 6 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para govbr-apis-mcp@0.2.0

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/thalisantunes-govbr-apis-mcp.svg)](https://mcp.popnx.com/en/servers/thalisantunes-govbr-apis-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Derecho y datos públicosi

  • Más estrellas que el 87% de los otros 1945 servidores de esta categoría
  • Publicado en el registro más recientemente que el 51% de los otros 1945 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 1945 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro gov.br APIs MCP?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: 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

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 6 días, y la última versión (0.2.0) llegó al registro hace 30 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

de lexifinaMuy usado★ 2,1 milActualizado hace 9 días

Se ejecuta en la nube✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

de librejusticeInicial★ 36Actualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

de street1983nkInicial★ 18Actualizado hace 5 meses

Se ejecuta en la nube✓ del servicio · infranode.dev

Fedlex Connector

Search Swiss federal legislation: laws, articles, amendments via the Fedlex SPARQL endpoint.

de JayTheSkierInicial★ 8Actualizado hace 7 meses

Se ejecuta en la nube✓ del servicio · fedlex-connector.ch
Comparado con otros parecidos
Este
gov.br APIs MCP
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/34/44/44/44/44/4
LicenciaMITNOASSERTIONMITApache-2.0Apache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

govbr-apis-mcp

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.

Catalog tiers

TierFileAccess modelCallable today?
publicsrc/govbr_apis_mcp/catalog_data/public.yamlFree — no auth or free API key (IBGE, Banco Central, Câmara, Senado, Portal da Transparência, DataJud, Ipeadata, dados.gov.br…)Yes
serprosrc/govbr_apis_mcp/catalog_data/serpro.yamlSerpro commercial (loja.serpro.gov.br) — OAuth2 client credentials per contracted API, paid per callWith a Serpro contract: set the SERPRO_* variables
meia-entradasrc/govbr_apis_mcp/catalog_data/meia_entrada.yamlEligibility sources for half-price tickets (student CIE, ID Jovem, PcD, e-MEC) — see docs/meia-entrada.md and the POCCIE yes (DNE and FESN); the rest is manual
conectasrc/govbr_apis_mcp/catalog_data/conecta.yamlConecta gov.br — restricted to public-sector entities; 95 APIs indexed as stubs for discoveryNot 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).

Tools

  • 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.
  • A query string embedded in path is merged with query; a key in query replaces the embedded one, and a list value repeats the key.
  • Caller headers are matched case-insensitively, with _ 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.
  • Method, body, headers and path are validated before any OAuth2 token is requested, and invalid input comes back as {"error": ...}.
  • A 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).

POC: meia-entrada de estudante

Fluxo funcional ponta a ponta (código da CIE → decisão de elegibilidade), incluindo modo demo sem credencial: poc/README.md.

Install

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

Credentials

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

Extending the catalog

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.

Development

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.

Security notes

  • Responses are never written to disk. Only OpenAPI specs are cached, in $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).
  • Cookies an API sets are never stored or sent back, so one API cannot plant a cookie that another would receive.
  • Spec fetches follow redirects only by hand: at most 5 hops, and every URL (the first and each 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.
  • The httpx and httpcore loggers stay at WARNING, so httpx logs no request URL (query string included).
  • Entries flagged 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.

Roadmap

  • Conecta adhesion as a public-sector entity → fill gateway base URLs + credentials
  • Per-API OpenAPI URLs for Conecta entries (linked from each detail page)
  • Serpro trial-mode toggle (call -trial base URLs with the published demo token)
  • Per-call cost guard for paid Serpro APIs
  • Bounded decompression for compressed upstream responses
  • Pleito à SNJ para a API conecta-id-jovem (admite instituição privada)
  • Fallback documental para CIE fora da base DNE (DCEs e entidades estaduais)

License

MIT - see LICENSE.