mcp-stark-bank について
mcp-stark-bank は、デジタルバンク Stark Bank 向けの MCP サーバーで、送金、boleto、請求書、Pix、残高照会を提供します。ブラジルの銀行業務を扱う開発者や経理チームを想定しており、テスト用のサンドボックスモードにも対応しています。
主な機能
- 01Pix と TED による送金の作成と照会
- 02boleto による入金請求の発行と管理
- 03Pix QR コード付き請求書の生成
- 04Pix キーと入金の管理
- 05BR Code、税金、公共料金の支払い
- 06マルチテナント用サブアカウントのワークスペース一覧
活用シーン
- 01サンドボックス環境でのエージェントによる支払いフローのテスト
- 02boleto の発行と支払い状況の追跡
- 03口座残高と入金明細の確認
MCP 対応
本プロジェクトは MCP サーバーであり、Stark Bank API を通じて送金、入金請求、Pix、口座操作に関する 27 のツールを MCP クライアントに公開します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
27掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| name | string | はい | 受取人名 |
| tags | array | いいえ | 組織のタグ |
| taxId | string | はい | 受取人の CPF または CNPJ |
| amount | number | はい | 金額(センターボ単位、例:1000 = R$10.00) |
| bankCode | string | はい | 銀行コード(例:Stark Bank の場合は '20018183') |
| branchCode | string | はい | 支店コード |
| accountType | enum | いいえ | アカウントの種類checking | savings | salary | payment |
| accountNumber | string | はい | 数字を含む口座番号 |
詳細
@codespar/mcp-stark-bank
Stark Bank 用の MCP サーバー — 振込、ボレート、請求書、Pix に対応するデジタルバンキング
クイックスタート
Claude Desktop
~/.config/claude/claude_desktop_config.json に追加します。
{
"mcpServers": {
"stark-bank": {
"command": "npx",
"args": ["-y", "@codespar/mcp-stark-bank"],
"env": {
"STARK_BANK_ACCESS_TOKEN": "your-token",
"STARK_BANK_SANDBOX": "true"
}
}
}
}
Claude Code
claude mcp add stark-bank -- npx @codespar/mcp-stark-bank
Cursor / VS Code
.cursor/mcp.json または .vscode/mcp.json に追加します。
{
"servers": {
"stark-bank": {
"command": "npx",
"args": ["-y", "@codespar/mcp-stark-bank"],
"env": {
"STARK_BANK_ACCESS_TOKEN": "your-token",
"STARK_BANK_SANDBOX": "true"
}
}
}
}
ツール(27)
| ツール | 用途 |
|---|---|
create_transfer | 銀行振込(Pix または TED)を作成します |
get_transfer | ID で振込の詳細を取得します |
list_transfers | 任意のフィルターを指定して振込の一覧を取得します |
create_boleto | ボレートの支払いを作成します |
get_balance | 現在の口座残高を取得します |
create_invoice | 請求書を作成します(Pix QR コードを生成します) |
get_invoice | ID で請求書の詳細を取得します |
list_invoices | 任意のフィルターを指定して請求書の一覧を取得します |
create_pix_request | Pix の支払いリクエストを作成します |
get_webhook_events | Webhook イベントを取得します(支払い確認、振込など) |
create_payment_request | 承認ワークフロー用の支払いリクエストを作成します |
get_payment_request | ID で支払いリクエストの詳細を取得します |
list_payment_requests | 任意のフィルターを指定して支払いリクエストの一覧を取得します |
create_brcode_payment | BR Code(Pix QR コード/コピー&ペースト)で支払います |
get_deposit | ID で入金の詳細を取得します(Pix または TED による入金) |
create_boleto_issue | 受取用のボレートを発行します(支払いを受け取るためのバーコード/入力行を生成します) |
get_boleto | ID で発行済みのボレートを取得します |
list_boletos | 任意のフィルターを指定して発行済みのボレートの一覧を取得します |
delete_boleto | 発行済みのボレートをキャンセルします(未払いで、「created」または「registered」状態の場合のみ可能です) |
create_pix_key | Pix キー(CPF/CNPJ、メールアドレス、電話番号、または EVP/ランダム)を登録します |
get_pix_key | ID で Pix キーの詳細を取得します |
list_pix_keys | 任意のフィルターを指定して登録済み Pix キーの一覧を取得します |
delete_pix_key | Pix キーをキャンセル/登録解除します |
list_deposits | 任意のフィルターを指定して入金(Pix または TED による入金)の一覧を取得します |
create_utility_payment | 公共料金を支払います(例: |
create_tax_payment | バーコード/入力行を使って税金(DARF、GPS、GRU など)を支払います |
list_workspaces | 組織がアクセスできるワークスペース(マルチテナントのサブアカウント)の一覧を取得します |
認証
Stark Bank では、API 認証に Bearer トークンを使用します。
サンドボックス/テスト
Stark Bank は sandbox.api.starkbank.com でサンドボックスを提供しています。使用するには STARK_BANK_SANDBOX=true を設定します。
認証情報を取得する
- Stark Bank にアクセスします
- アカウントを作成します
- ダッシュボードから API アクセストークンを生成します
- 環境変数を設定します
環境変数
| 変数 | 必須 | 説明 |
|---|---|---|
STARK_BANK_ACCESS_TOKEN | はい | API アクセストークン |
STARK_BANK_SANDBOX | いいえ | サンドボックスモードを使用するには "true" に設定します |
ロードマップ
v0.2(予定)
create_payment_request— 支払いリクエストを作成しますget_payment_request— 支払いリクエストの詳細を取得しますlist_payment_requests— フィルターを指定して支払いリクエストの一覧を取得しますcreate_brcode_payment— BR Code(Pix)の支払いを作成しますget_deposit— 入金の詳細を取得します
v0.3(予定)
create_workspace— 新しいワークスペースを作成しますtax_payment— 税金の支払いを作成します(DAS、DARF など)utility_payment— 公共料金の支払いを作成します(ボレート、請求書)
コントリビュートをご希望ですか?PR を作成するか、ツールをリクエストしてください。
リンク
エンタープライズ
エージェントの決済にガバナンス、予算上限、監査証跡が必要ですか?CodeSpar Enterprise は、これらの MCP サーバーにポリシーエンジン、決済ルーティング、コンプライアンステンプレートを追加します。
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。