Fin Codes API

Fin Codes API MCP サーバー

AI アシスタントを銀行参照データ、受取人名の照合、制裁スクリーニングに接続します。

ホステッドエンドポイント： https://mcp.fincodesapi.com/mcp

トランスポート： Streamable HTTP

ホームページとセットアップ： https://fincodesapi.com/mcp-server

公式レジストリ： com.fincodesapi/fincodesapi

このリポジトリには、ホステッドサービスの公開コネクター設定とドキュメントが含まれています。独自のバックエンドは含まれておらず、ローカルサーバーを実行することも、npm、PyPI、Docker パッケージを公開することもありません。

接続

エンドポイントをクライアントのリモート HTTP MCP サーバーとして追加し、OAuth を通じて Fin Codes API アカウントにサインインします。必要に応じて、https://fincodesapi.com/sign-up で登録してください。OAuth に対応したクライアントでは、手動で作成した API キーは必要ありません。

Claude Code

claude mcp add --transport http fincodesapi https://mcp.fincodesapi.com/mcp

/mcp を実行してサインインします。Claude Desktop または claude.ai では、エンドポイントをカスタムコネクターとして追加します。

VS Code

.vscode/mcp.json に追加してから、サーバーを起動し、サインインします。

{"servers":{"fincodesapi":{"type":"http","url":"https://mcp.fincodesapi.com/mcp"}}}

Cursor およびその他の MCP クライアント

クライアントの MCP 設定でリモートエンドポイントを追加します。付属の mcp.json は接続を定義し、plugin.json はポータブルな Agent Plugins マニフェストです。クライアントのサポート状況と OAuth の設定方法はそれぞれ異なります。

Cline

Cline で MCP Servers → Remote Servers を開き、上記のエンドポイントを追加して、Streamable HTTP を選択します。プロンプトが表示されたら OAuth 認証を完了します。JSON 設定を使用する場合は、Cline のトランスポート表記を使用してください。

{"mcpServers":{"fincodesapi":{"type":"streamableHttp","url":"https://mcp.fincodesapi.com/mcp","disabled":false,"autoApprove":[]}}}

お使いのクライアントのバージョンで OAuth が利用できない場合は、https://fincodesapi.com/api-keys でご自身の API トークンを作成し、ローカルで Authorization: Bearer YOUR_API_KEY ヘッダーを追加してください。キーを共有ファイルに含めないでください。ツールが 11 個表示されることを確認し、BSB 082-024 を検索してみてください。

Cline の MCP ドキュメントを参照してください。このコネクターの Cline へのインストールは、まだ独立してテストされていません。

Gemini CLI

gemini extensions install https://github.com/swiftcodesapi/fincodesapi-mcp

サインインを求められたら、/mcp auth fincodesapi を実行します。この拡張機能は HTTP トランスポートと OAuth ディスカバリーを使用します。

API キーを使うクライアント

OAuth に対応していないクライアントでは、https://fincodesapi.com/api-keys で作成した API キーを使用できます。同じエンドポイントに Authorization: Bearer YOUR_API_KEY を送信します。実際のキーはクライアントのシークレットストアに保管し、このリポジトリにコミットしないでください。

11 個のツール

ツール	目的
lookup_iban	IBAN を検証し、銀行、国、BIC/SWIFT の詳細を返します
verify_iban_payee	指定された受取人名を、対応している欧州の IBAN の口座名義人と照合します
lookup_bic	BIC/SWIFT の銀行および支店の詳細を特定します
lookup_us_routing_number	米国の ABA ルーティング番号を検索します
lookup_canada_routing_number	カナダのルーティング番号を検索します
lookup_australia_bsb	オーストラリアの BSB を検索します
lookup_new_zealand_bank_code	ニュージーランドの銀行・支店コードを検索します
lookup_india_ifsc	インドの IFSC を検索します
lookup_mexico_clabe	メキシコの CLABE を検証し、銀行を特定します
lookup_argentina_cbu	アルゼンチンの CBU を検証し、銀行を特定します
screen_sanctions	EU、英国、国連、OFAC、スイス、オーストラリア、カナダの制裁リストと名前を照合します

稼働中の MCP ツールスキーマが正式な情報源です。

使用例

• 「DE57 1001 0010 0593 9081 19 を検証して、銀行と BIC を教えてください。」
• 「オーストラリアの BSB 082-024 は、どの銀行と支店を示していますか？」
• 「ドキュメントに記載された無料の受取人確認用テストデータを実行してください。DE75512108001245126199 は John Doe と一致しますか？」
• 「名前 Sadam Husein を、最小一致スコア 95 でスクリーニングしてください。」

John Doe と IBAN の組み合わせは、ドキュメントに記載されたテストデータです。その応答は、実際の口座所有者を証明するものではありません。銀行コードの有効性だけでは、口座の存在や所有者は確認できません。制裁リストとの名前の類似性は確認が必要であり、本人確認や制裁対象であることを証明するものではありません。これらのツールは、送金、取引の実行、名前による非公開口座の逆引き、信用力の判定を行いません。

アカウントと料金

Fin Codes API アカウントが必要です。照会にはアカウントのプラン枠が使用され、受取人の確認には前払いの Verification of Payee クレジットが使用されます。プランとクレジットは https://fincodesapi.com/pricing で購入できます。このコネクターは購入や支払いを処理しません。トライアルをご利用いただけます。現在の利用条件と上限はウェブサイトに記載されています。

プライバシーとサポート

入力内容はホスト型の Fin Codes API サービスに送信されます。利用前に https://fincodesapi.com/privacy-policy、https://fincodesapi.com/gdpr、https://fincodesapi.com/terms-of-service をご確認ください。サポート：[email protected]、または https://fincodesapi.com/mcp-server からお問い合わせください。

ライセンス

このリポジトリのコネクター設定とドキュメントは MIT ライセンスです。ホスト型サービスには引き続き利用規約が適用されます。