プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

gov.br APIs MCP

作者:thalisantunesバージョン 0.2.0i★ 1iパソコンで動くリポジトリ ↗
レジストリ名io.github.thalisantunes/govbr-apis-mcp

インストール方法

What it does

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

  • Connects パソコンで動く
  • 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 法律・行政データ

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気4/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア16/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

gov.br APIs MCP をインストールして。https://mcp.popnx.com/i/thalisantunes-govbr-apis-mcp.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

gov.br APIs MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server gov.br APIs MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(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) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) 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 は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、gov.br APIs MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. gov.br APIs MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

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

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude を終了してもう一度開く

  6. 試してみる

    gov.br APIs MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が gov.br APIs MCP を使っていると言うか、回答に gov.br APIs MCP のツール名が出れば接続成功です

追加の設定 4 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • GOVBR_CATALOG_DIR パッケージ付属のカタログを置き換えるカタログ YAML ファイルのディレクトリ(信頼された入力)。
    英語の原文を見るDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR カタログ YAML ファイルのディレクトリ。そのエントリはカタログに追加され、同じ id のエントリは上書きされる。
    英語の原文を見るDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS カタログ URL が使用できる追加ホスト名のカンマ区切りリスト。送信される認証情報を預けてもよいと信頼する場合にのみ追加してください
    英語の原文を見るComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME OpenAPI 仕様キャッシュのベースディレクトリ(その下に govbr-apis-mcp フォルダが作成されます)。既定値は /.cache
    英語の原文を見るBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ gov.br APIs MCP につなげません

gov.br APIs MCP はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · gov.br APIs MCP につなげるアプリを使う

  • gov.br APIs MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • gov.br APIs MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • gov.br APIs MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • gov.br APIs MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · 法律・行政データ の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

gov.br APIs MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server gov.br APIs MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(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) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) 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 は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、gov.br APIs MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. gov.br APIs MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて 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

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Claude Code で /mcp と入力

    gov.br APIs MCP が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    gov.br APIs MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が gov.br APIs MCP を使っていると言うか、回答に gov.br APIs MCP のツール名が出れば接続成功です

追加の設定 4 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • GOVBR_CATALOG_DIR パッケージ付属のカタログを置き換えるカタログ YAML ファイルのディレクトリ(信頼された入力)。
    英語の原文を見るDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR カタログ YAML ファイルのディレクトリ。そのエントリはカタログに追加され、同じ id のエントリは上書きされる。
    英語の原文を見るDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS カタログ URL が使用できる追加ホスト名のカンマ区切りリスト。送信される認証情報を預けてもよいと信頼する場合にのみ追加してください
    英語の原文を見るComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME OpenAPI 仕様キャッシュのベースディレクトリ(その下に govbr-apis-mcp フォルダが作成されます)。既定値は /.cache
    英語の原文を見るBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

gov.br APIs MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server gov.br APIs MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(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) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) 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 は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、gov.br APIs MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. gov.br APIs MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    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 が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    gov.br APIs MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が gov.br APIs MCP を使っていると言うか、回答に gov.br APIs MCP のツール名が出れば接続成功です

追加の設定 4 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • GOVBR_CATALOG_DIR パッケージ付属のカタログを置き換えるカタログ YAML ファイルのディレクトリ(信頼された入力)。
    英語の原文を見るDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR カタログ YAML ファイルのディレクトリ。そのエントリはカタログに追加され、同じ id のエントリは上書きされる。
    英語の原文を見るDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS カタログ URL が使用できる追加ホスト名のカンマ区切りリスト。送信される認証情報を預けてもよいと信頼する場合にのみ追加してください
    英語の原文を見るComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME OpenAPI 仕様キャッシュのベースディレクトリ(その下に govbr-apis-mcp フォルダが作成されます)。既定値は /.cache
    英語の原文を見るBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

gov.br APIs MCP のキーが必要です(提供元のサイトで作成) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server gov.br APIs MCP を入れてください。順番に:1) uv --version で uv があるか確認。なければ https://docs.astral.sh/uv/getting-started/installation/ から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(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) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) 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 は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、gov.br APIs MCP のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. gov.br APIs MCP に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    キーの取り方は下の提供元 README にあります

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    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 が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    gov.br APIs MCP を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が gov.br APIs MCP を使っていると言うか、回答に gov.br APIs MCP のツール名が出れば接続成功です

追加の設定 4 項目(入力しなくても使えます)

上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。

  • GOVBR_CATALOG_DIR パッケージ付属のカタログを置き換えるカタログ YAML ファイルのディレクトリ(信頼された入力)。
    英語の原文を見るDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR カタログ YAML ファイルのディレクトリ。そのエントリはカタログに追加され、同じ id のエントリは上書きされる。
    英語の原文を見るDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS カタログ URL が使用できる追加ホスト名のカンマ区切りリスト。送信される認証情報を預けてもよいと信頼する場合にのみ追加してください
    英語の原文を見るComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME OpenAPI 仕様キャッシュのベースディレクトリ(その下に govbr-apis-mcp フォルダが作成されます)。既定値は /.cache
    英語の原文を見るBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?gov.br APIs MCP を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

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

自分で入力する値

  • TRANSPARENCIA_API_KEY 秘密 必須 env
    Portal da Transparencia API 用の API キー。
    英語の原文を見るAPI key for the Portal da Transparencia API
  • DATAJUD_API_KEY 秘密 必須 env
    CNJ DataJud API 用の API キー。
    英語の原文を見るAPI key for the CNJ DataJud API
  • DADOSGOV_API_KEY 秘密 必須 env
    dados.gov.br ポータル API 用の API キーです(無料。ユーザープロフィールで生成します)。
    英語の原文を見るAPI key for the dados.gov.br portal API (free, generated in the user profile)
  • SERPRO_CPF_CLIENT_ID 秘密 必須 env
    Serpro CPF API 用の OAuth2 クライアント ID(商用契約)
    英語の原文を見るOAuth2 client ID for the Serpro CPF API (commercial contract)
  • SERPRO_CPF_CLIENT_SECRET 秘密 必須 env
    Serpro CPF API の OAuth2 クライアントシークレットです(商用契約)。
    英語の原文を見るOAuth2 client secret for the Serpro CPF API (commercial contract)
  • SERPRO_CNPJ_CLIENT_ID 秘密 必須 env
    Serpro CNPJ API 用の OAuth2 クライアント ID(商用契約)
    英語の原文を見るOAuth2 client ID for the Serpro CNPJ API (commercial contract)
  • SERPRO_CNPJ_CLIENT_SECRET 秘密 必須 env
    Serpro CNPJ API の OAuth2 クライアントシークレットです(商用契約)。
    英語の原文を見るOAuth2 client secret for the Serpro CNPJ API (commercial contract)
  • SERPRO_DATAVALID_CLIENT_ID 秘密 必須 env
    Serpro Datavalid API 用の OAuth2 クライアント ID(商用契約)
    英語の原文を見るOAuth2 client ID for the Serpro Datavalid API (commercial contract)
  • SERPRO_DATAVALID_CLIENT_SECRET 秘密 必須 env
    Serpro Datavalid API の OAuth2 クライアントシークレットです(商用契約)。
    英語の原文を見るOAuth2 client secret for the Serpro Datavalid API (commercial contract)
  • MEIAENTRADA_CODIGO_ACESSO 秘密 必須 env
    meia-entrada で使用する CIE バリデーターのアクセスコード(codigoAcesso)。会場または主催者に発行されます。
    英語の原文を見るAccess code (codigoAcesso) for the CIE validator used for meia-entrada, issued to the venue or producer
  • GOVBR_CATALOG_DIR env
    パッケージ付属のカタログを置き換えるカタログ YAML ファイルのディレクトリ(信頼された入力)。
    英語の原文を見るDirectory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR env
    カタログ YAML ファイルのディレクトリ。そのエントリはカタログに追加され、同じ id のエントリは上書きされる。
    英語の原文を見るDirectory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS env
    カタログ URL が使用できる追加ホスト名のカンマ区切りリスト。送信される認証情報を預けてもよいと信頼する場合にのみ追加してください
    英語の原文を見るComma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME env
    OpenAPI 仕様キャッシュのベースディレクトリ(その下に govbr-apis-mcp フォルダが作成されます)。既定値は /.cache
    英語の原文を見るBase directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
23/週
接続方法
パソコンで動く
最新バージョンi
0.2.0
レジストリ公開日i
2026年10月20日
コードの最終更新i
2026年11月13日
作者
thalisantunes
パッケージ
pypi: govbr-apis-mcp
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

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

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント thalisantunes で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:6 日前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に govbr-apis-mcp@0.2.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

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

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

法律・行政データのほかのサーバーとの比較i

  • このカテゴリのほかの1945件のうち87%よりスターが多い
  • このカテゴリのほかの1945件のうち51%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1945件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

gov.br APIs MCPは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの: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

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は6 日前、最新バージョン(0.2.0)がレジストリに届いたのは30 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Global law

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

作者:lexifina広く使われている★ 20969 日前更新

クラウドで動く✓ lexifina.com

LibreJustice

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

作者:librejustice初期★ 362 か月前更新

クラウドで動く✓ 提供元 · librejustice.fr

InfraNode

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

作者:street1983nk初期★ 185 か月前更新

クラウドで動く✓ 提供元 · infranode.dev
似たものと比べる
これ
gov.br APIs MCP
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/44/44/44/44/4
ライセンスMITNOASSERTIONMITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

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.