Lunium — Brazilian PIX and stablecoin payments について
LuniumPay Agent Skillsは、ブラジルのPixとステーブルコイン決済を統合するコーディングエージェント向けのスキルとスクリプト集です。Pixの受け取りと暗号資産での決済、暗号資産によるPix支払い、Webhook、サンドボックステスト、本番設定を複数の技術スタックで扱います。
主な機能
- 01対応スタック向け決済ルートの生成
- 02サンドボックスでの決済フローのテスト
- 03本番キーとWebhookの設定
- 04Pix受け取りとステーブルコイン決済の統合
- 05暗号資産によるPix支払いへの対応
活用シーン
- 01PixからUSDT/USDCへの決済フロー追加
- 02実資金を使わない成功・失敗シナリオのテスト
- 03署名付きWebhook処理の設定
- 04本番環境の決済連携の構築
MCP 対応
スキルは、20個のツールを提供するLuniumPayのMCPエンドポイント https://api.luniumpay.com/mcp を参照します。APIを使った決済連携もエージェントに案内します。
設定
リモートサーバーはインストール不要です。クライアントを選んで設定をコピーするか、ワンクリックで導入できます。
https://api.luniumpay.com/mcpclaude mcp add --transport http com-luniumpay-pix-brazilian-payments https://api.luniumpay.com/mcp{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}Cursor で開く{"servers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}VS Code で開く{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"type":"http","url":"https://api.luniumpay.com/mcp"}}}{"mcpServers":{"com-luniumpay-pix-brazilian-payments":{"serverUrl":"https://api.luniumpay.com/mcp"}}}コマンドはターミナルで実行し、JSON は各クライアントの MCP 設定に貼り付けて再起動します。認可が必要なサーバーは初回接続時にログインを求めます。
ツール
20| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| name | string | いいえ | 後でダッシュボード上で人がキーを識別できるようにする任意のラベル。例：エージェント名やプロジェクト名。 |
| string | いいえ | テストする人のメールアドレス。指定を強く推奨します。LuniumPay はその人に統合ガイド（LuniumPay の概要、マニュアル、フローチャート、次の手順）を 1 回送信します。人間に尋ねてください。決して捏造しないでください。まだ分からない場合は、先にキーを作成し、後で lunium_contact から送信してください。 |
詳細
LuniumPay Agent Skills
PT · Pix ⇄ ブラジルのステーブルコイン決済を、AI エージェントと連携します。インストールして、「Pix を受け取り、USDT でウォレットに入金して」と頼めば、エージェントがすべて行います。キーの作成から、バックエンド、QR、Webhook、サンドボックス、本番環境まで対応します。 EN · ブラジルの Pix ↔ ステーブルコイン決済を、コーディングエージェントと連携します。 インストールして、「Pix を受け取り、USDT でウォレットに入金して」と頼めば、あとはエージェントが行います。
Claude Code、Cursor、Codex、Gemini CLI、Windsurf、Antigravity、および Agent Skills 標準を読み込めるあらゆるエージェントで動作します。
インストール / Install
npx skills add LuniumPay/lunium-agent-skills
Claude Code の場合、プラグインマーケットプレイスからインストールできます（更新を受け取れます）。
/plugin marketplace add LuniumPay/lunium-agent-skills
/plugin install luniumpay@lunium-agent-skills
手動の場合：フォルダーをエージェントのスキルディレクトリ（.claude/skills/、.cursor/skills/、.codex/skills/、.agents/skills/）にコピーします。
内容 / What's inside
| スキル | 次の場合に使用… | 追加内容 |
|---|---|---|
luniumpay | ここから始めましょう。 概要、判断ツリー、7 ステップの手順、11 のルール、サンドボックスのシミュレーション内容 | 状態、エラー、チェックリスト、事業者向け FAQ、プロンプト、MCP（20 ツール）、スタック別の本番環境ガイドを含む references/ · scripts/init.mjs、doctor.mjs、go-live.mjs |
luniumpay-pix-charge | Pix を受け取り、ウォレット（または残高）に USDT/USDC を入金する | Next.js、Express、FastAPI、Supabase Edge のレシピ、React チェックアウトコンポーネント · scripts/smoke.mjs |
luniumpay-custody | ウォレットなしのレアル残高、サブアカウント、保留期間、暗号資産の出金、残高による Pix 支払い | scripts/smoke-custody.mjs（保留期間を含む） |
luniumpay-webhooks | 署名付きイベントを安全に受信する | 公式検証ツール + テスト |
luniumpay-crypto-sale | 暗号資産で Pix を支払う（キャッシュアウト）：カタログ、事前確認、注文、承認、返金 | scripts/smoke-cashout.mjs |
luniumpay-usdt-wallet | USDT 残高と、それを使った Pix 支払い（キーまたはコピー＆ペースト） | |
luniumpay-verify-payment | キーなしで Pix の決済を証明する |
1 つのコマンドでプロジェクトに組み込む / Scaffold into your project
node luniumpay/scripts/init.mjs --email [email protected] # detecta Next.js, Express, FastAPI ou Supabase
公式レシピの決済、ステータス、Webhook のルートをプロジェクトに書き込みます（既存のファイルは上書きしません）。.env.example を作成し、サンドボックスキーをローカルの .env に保存します（0600、画面には表示しません）。次の手順も一覧表示します。
--stack next|express|fastapi|supabase でスタックを指定できます。--dry は計画を表示するだけです。
お金を使わずにテストする / Try with no money
export [email protected] # recebe 1 e-mail com o manual
node luniumpay/scripts/doctor.mjs # diagnóstico da chave (após criar)
node luniumpay-pix-charge/scripts/smoke.mjs cripto success
node luniumpay-pix-charge/scripts/smoke.mjs cripto failed
node luniumpay-custody/scripts/smoke-custody.mjs
node luniumpay-crypto-sale/scripts/smoke-cashout.mjs USDT polygon
node luniumpay-crypto-sale/scripts/smoke-cashout.mjs DEPIX liquid settlement_uncertain
node luniumpay-webhooks/scripts/verify-webhook.test.mjs
スクリプトはテストキー（lun_test_）を作成し、決済を請求して Pix をシミュレーションし、最終状態を読み取ります。本番キーは拒否されます。実際のお金は一切動きません。
1 つのコマンドで本番環境を完全にセットアップ / Production in one command
node luniumpay/scripts/go-live.mjs --name "Minha Empresa" --email [email protected] \
--webhook https://seu-dominio.com/api/webhooks/lunium --vercel # ou --env .env.lunium.production
lun_live_… キーをその場で作成し（承認不要）、秘密鍵付きで Webhook を登録し、ホストにシークレットを保存して（画面には表示しません）、POST /webhooks/test で配信を確認します。サンドボックスと同じ契約で、変更するのは変数だけです。スタック別のデプロイと初回の実決済については、luniumpay/references/producao.md を参照してください。
キーのみを curl で作成する場合：curl -X POST https://api.luniumpay.com/keys -H 'Content-Type: application/json' -d '{"name":"Minha Empresa","email":"[email protected]"}'。
信頼できる情報源 / Source of truth
SKILL.md は意図的に短くしています。最新の仕様を参照してください：
openapi.json · llms.txt ·
integration.json · サンドボックス ·
MCP https://api.luniumpay.com/mcp。スキル 2.2.0 · 改訂日 2026-10-25 · API 1.45.2。
サポート：[email protected] · https://wa.me/27722944340 · Lunium Partners（Telegram）
ライセンス
MIT。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。