JP-Verify

jp-verify-mcp

JP-Verify 用の MCP サーバーです。JP-Verify は、日本企業を検証する英語優先の API です。適格請求書発行事業者の登録番号（T番号）、法人番号、英語名、大株主を確認できます。

これは薄いクライアントです。各ツール呼び出しは、JP-Verify の公開 API https://jp-verify.obolpay.xyz への HTTPS リクエスト 1 回です。このパッケージは登記データを保持せず、ほかのサイトにも接続しません。国税庁や EDINET からデータをダウンロードすることもありません。

ツール

ツール	JP-Verify のエンドポイント	戻り値
verify_japanese_company	GET /v1/verify	登録状況と日付、法人番号、日本語の名称と住所、英語の名称と住所（公式または機械によるローマ字表記のラベル付き）
verify_japanese_companies_batch	POST /v1/verify	複数の番号について同じ情報を返します。Sandbox と Starter キーでは 1 回につき最大 100 件、Growth では 500 件、Reseller では 1,000 件です。形式が不正な番号は invalid に記載され、課金されません
get_major_shareholders	GET /v1/shareholders	EDINET に提出された企業の有価証券報告書にある「大株主の状況」表、または no_public_disclosure の記載。as_of（YYYY-MM-DD）は省略可能です
find_japanese_company_by_name	GET /v1/resolve	企業名に該当する法人番号の候補（ルールベースの完全一致であり、あいまい検索ではありません）

4 つとも読み取り専用です。応答が返された呼び出し（HTTP 200）は、JP-Verify のプランで 1 件の従量制照会としてカウントされます。バッチツールでは、形式が正しい番号ごとに 1 件としてカウントされます。verify_japanese_company と get_major_shareholders は、JP-Verify 独自の書式またはチェックディジットの規則に合わない番号をローカルで拒否し、API を呼び出しません。バッチツールはリストをそのまま送信し、該当する番号を invalid に記載します。料金はかかりません。

各結果には 2 つの部分があります。

• jp_verify_response：data_as_of、注記、免責事項、attribution 文字列を含む、JP-Verify から送信された回答そのものです。
• metadata：エンドポイント、HTTP ステータス、API キーとキー不要の Sandbox のどちらを使ったか、クォータヘッダー（limit、remaining、resets_at）、データの取得元です。

HTTP エラー（400、401、404、429、503、5xx）とネットワーク障害は、1 行の説明を付けたツールエラーとして返されます。JP-Verify は、400、401、404、429、503 の応答には課金しません。

インストールと実行

Python 3.10 以降が必要です。

uvx jp-verify-mcp                # or: pip install jp-verify-mcp && jp-verify-mcp

ソースをチェックアウトしている場合は、pip install . を実行し、続けて jp-verify-mcp を実行します。

stdio（デフォルト）

Claude Desktop、Claude Code（.mcp.json）、Cursor、その他のローカルサーバーを起動するクライアントの場合：

{
  "mcpServers": {
    "jp-verify": {
      "command": "uvx",
      "args": ["jp-verify-mcp"],
      "env": { "JPVERIFY_API_KEY": "your key (optional)" }
    }
  }
}

キー不要の Sandbox を使う場合は、env を省略してください。

Streamable HTTP

jp-verify-mcp --transport streamable-http --host 127.0.0.1 --port 8000
# endpoint: http://127.0.0.1:8000/mcp  (stateless, JSON responses)

• クライアントは X-API-Key ヘッダーで独自のキーを送信できます。そのキーは該当する呼び出しに限り JP-Verify に転送され、JPVERIFY_API_KEY より優先されます。
• ループバックアドレスにバインドすると、DNS リバインディング対策が自動的に有効になります。パブリックホスト名の場合は、--allowed-host your.host.name を渡してください（複数回指定できます）。
• ループバック以外のアドレスでは、JPVERIFY_API_KEY が設定されているとサーバーは起動を拒否します。独自のキーを持たないすべての呼び出し元がそのキーを使うことになるためです。それが意図した動作の場合は、--allow-shared-key を渡してください。
• Sandbox の利用枠は IP アドレスごとに設定されます。そのため、ホストされたエンドポイントをキーなしで呼び出すクライアントは、ホストの利用枠を共有します。

設定

変数	デフォルト	意味
JPVERIFY_API_KEY	unset	X-API-Key として送信する JP-Verify API キーです。未設定の場合はキー不要の Sandbox を使います
JPVERIFY_BASE_URL	https://jp-verify.obolpay.xyz	API のオリジンです。プレーンな http:// は localhost に限り使用できます
JPVERIFY_TIMEOUT	20	リクエストごとのタイムアウト秒数（最大 120 秒）

その他のオプションについては、jp-verify-mcp --help を参照してください。

Keys and plans

• Without a key, JP-Verify's key-less sandbox answers. It is limited per IP address per day (JP-Verify documents 50 requests a day, as of 2026-10-07) and JP-Verify may change or end it (its Terms, Article 4).
• Paid plans and their prices are published on JP-Verify's legal notice: https://jp-verify.obolpay.xyz/legal. For a key, see https://jp-verify.obolpay.xyz or write to [email protected].

Data, sources and attribution

• Registration status, Corporate Number and Japanese name and address come from data published by Japan's National Tax Agency (国税庁): 国税庁適格請求書発行事業者公表サイト (qualified invoice issuers) and 国税庁法人番号公表サイト (Corporate Numbers), mirrored and processed by JP-Verify. They are not produced or guaranteed by the National Tax Agency.
• English names: official-en where the company filed an English name with the Corporate Number register; otherwise generated, a machine romanisation that is not authoritative. Most companies have not filed one.
• Sole proprietors: number, status and dates only. No name or address is returned.
• Major shareholders: the 「大株主の状況」 tables companies file on the FSA's EDINET, extracted by JP-Verify. Organisations are named; every other holder, including every individual, is reported without a name, normally as an aggregate (always on the sandbox). Only companies that file a 有価証券報告書 or 半期報告書 publish this table; for any other company JP-Verify returns no_public_disclosure, a statement of why nothing is published (not a claim that the company has no shareholders). Some filers may show not_yet_available while JP-Verify's ingest catches up. JP-Verify switches this route on separately (its /health reports major_shareholders.enabled); until then the tool answers route_not_enabled.
• JP-Verify may add the FSA's EDINET code list (PDL1.0) and GLEIF LEI data (CC0 1.0) to a result.
• When you republish data from a response, keep its attribution strings and *_register blocks (JP-Verify Terms, Article 5).
• These are register facts as of the dates each response states. They are not tax, legal, investment or ownership advice. JP-Verify answers 503 rather than serve data older than its freshness window.

Privacy

The server sends JP-Verify only what a tool is asked about (numbers, a name, a date) and the API key, if any. It stores nothing, keeps no cache, never retries a call and adds no logging of its own; at the default log level (WARNING) request contents are not logged. JP-Verify's privacy statement: https://jp-verify.obolpay.xyz/v1/privacy. Terms: https://jp-verify.obolpay.xyz/terms.

Development

python3 -m venv .venv && .venv/bin/pip install -e '.[test]'
.venv/bin/python -m pytest

The tests never reach JP-Verify: HTTP is mocked, or answered by a stand-in on 127.0.0.1.

Company and contact

Yanagi the First Co., Ltd. (株式会社ヤナギtheファースト) · [email protected] · https://jp-verify.obolpay.xyz

License

MIT, for this client. Use of the JP-Verify service is governed by its Terms of Service.

Registry

Official MCP Registry name: xyz.obolpay/jp-verify. Source: https://github.com/Hiroshi-Ichiyanagi/jp-verify-mcp