Ripio (community, read-only)

ripio-community-mcp

非公式のコミュニティ製であり、Ripio とは無関係です。読み取り専用です。ご自身の責任でご利用ください。

AI アシスタントがご自身の API キーを使って Ripio アカウント（残高、利用履歴、価格、上限、未決済注文、入金アドレス）を読み取れる、ローカルの MCP サーバーです。お使いのコンピューター上で動作し、api.ripio.com とのみ通信します。

🇦🇷 スペイン語の手順：README.es.md

Ripio 公式 MCP ではなく、これを使う理由は？

Ripio には公式のリモート MCP サーバーがあります。問題なく使える場合は、そちらをご利用ください。このプロジェクトは、公式サーバーで対応できないケースを想定しています。

	公式（api.ripio.com/mcp）	ripio-community-mcp
クライアント	Ripio が承認した OAuth クライアントのみ（Claude、ChatGPT、VS Code）	ローカル（stdio）サーバーを実行できるすべての MCP クライアント：Claude Desktop/Code、Cursor、VS Code、Zed、Cline…
認証	ブラウザーで OAuth	ローカルに保存した Ripio API キー
ツール	約70個のエンドポイントミラー	質問全体に回答する10個のツール
読み取り専用	選択する権限プリセットによる	組み込み：サーバーが送信できるのは GET リクエストのみ
ツールのメタデータ	読み取り専用／破壊的操作の注釈なし	すべてのツールに読み取り専用の注釈があり、型付きの出力を返します
資金の移動	Full プリセットでは可能	不可

どちらも、カード取引、アプリ内での売買、請求書の支払いは表示できません。Ripio の公開 API ではこれらに対応していません。

ツール

ツール	質問の例
ripio_get_portfolio	「Ripio にいくらあり、何を保有していますか？」
ripio_list_activity	「最近の出金履歴を教えてください」・「9月の Ripio Trade の明細を表示してください」
ripio_get_transaction	「取引1234の詳細を教えてください」
ripio_get_prices	「今、USDT はアプリと Ripio Trade でそれぞれいくらですか？」
ripio_estimate_trade	「Ripio Trade で100 USDTを買うといくらかかりますか？」
ripio_get_limits	「今日はあといくら出金できますか？」
ripio_list_open_orders	「未決済注文はありますか？」
ripio_get_deposit_address	「Tron 経由で USDT を送金するには、どのアドレスを使えばよいですか？」
ripio_verify_deposit_address	「このアドレスは本当に自分のものですか？Polygon 経由で USDT を送金するところです」
ripio_get_deposit_accounts	「自分の CVU とエイリアスを教えてください」

入金時の安全対策

ネットワークの選択ミス、メモの記入漏れ、1文字の入力間違いで資金を失う可能性があるため、入金には安全対策を追加しています。

1. 正確な出力。 アドレスとメモは、Ripio が返した内容をそのまま返します。サーバーがアドレスを生成することはありません。Ripio がまだネットワーク用のアドレスを割り当てていない場合は、Ripio アプリで入金を開始するよう案内します。
2. ネットワークのルール。 ripio_get_deposit_address は、ネットワークが明確になるまでアドレスを返しません。アドレスとともに、そのアドレスで資産が入金されるネットワークと、別のアドレスが必要なネットワークも示します。EVM アドレスはすべての EVM ネットワークで同じですが、Ripio が各資産の入金を受け付けるネットワークは一部に限られます。
3. コードによる検証。 アシスタントは読み取った内容を入力し直しますが、まれに LLM が文字を変更してしまうことがあります。送信する前に、実際に使用するアドレスを貼り付けて検証を依頼してください。ripio_verify_deposit_address は、入力されたアドレスを実際のアドレスと1文字ずつ比較し、似ているものの一致しないアドレスを検出します。
4. ネットワークのチェックサム。 多くのネットワーク（大文字と小文字を区別するアドレスを使う EVM、Tron、Bitcoin、XRP、Stellar など）にはチェックサムがあるため、通常、送信元のウォレットは入力ミスのあるアドレスを拒否します。Solana アドレスにはチェックサムがありません。

高額を送る場合は、まず少額のテスト入金を行ってください。ここで示すのは Ripio アプリ（ウォレット）のアドレスです。Ripio Trade では別のアドレスを使用します。

CVU に送金されたペソは、Ripio アプリのプロフィールで設定した入金通貨に入金されます。入金通貨が暗号資産の場合、ペソは自動的に換金されます。ripio_get_deposit_accounts でもこの点を確認できます。

セットアップ

1. Ripio で読み取り専用 API キーを作成する

以下の手順では、Ripio の英語版インターフェースの表示名を使用しています。スペイン語で表示されている場合は、README.es.md に従うか、Profile → Preferences → Language で表示言語を切り替えてください。

1. app.ripio.com を開き、アバター（右上）をクリックして、Profile → API タブ → New key の順に選択します。
2. IP restriction： Specific IPs を選択して公開 IP を追加することを推奨します。または、No restriction を選択します。自宅の接続では、公開 IP がときどき新しく割り当てられることがあります。その場合、新しい IP をキーに追加するまで、サーバーは 403 を返します。
3. キーに名前を付け、Read-only プリセットを選択したままにします（Consult 9/9、Operate within Ripio 0/3、Withdrawals and addresses 0/2）。
4. 2FA で確認し、API Key と Secret Key をコピーします。シークレットは一度しか表示されません。

Ripio の「Read-only」プリセットでも、API キーを使って自分名義の銀行口座を登録できます。このサーバーはそのエンドポイントを呼び出しません。

2. クライアントに追加する

Claude Desktop（最も簡単です）。 最新リリースからripio-community-mcp.mcpbをダウンロードします。Claude DesktopでSettings → Extensions → Advanced settings → **Install Extension…**の順に開き、ファイルを選択して、求められたらAPIキーとシークレットを貼り付けます。Claude Desktopはそれらをシステムのキーチェーンに保存します。その後、通常のチャットで、たとえば「Ripioにはいくらあって、何を持っていますか？」と質問してください。

Claude Code

claude mcp add --env RIPIO_API_KEY=your-key --env RIPIO_API_SECRET=your-secret --transport stdio ripio -- npx -y ripio-community-mcp

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "ripio": {
      "command": "npx",
      "args": ["-y", "ripio-community-mcp"],
      "env": { "RIPIO_API_KEY": "your-key", "RIPIO_API_SECRET": "your-secret" }
    }
  }
}

VS Code（.vscode/mcp.json、またはすべてのワークスペースで使う場合はMCP: Open User Configuration）。VS Codeはキーとシークレットを一度だけ尋ね、安全に保存します。

{
  "inputs": [
    { "type": "promptString", "id": "ripio-key", "description": "Ripio API key", "password": true },
    { "type": "promptString", "id": "ripio-secret", "description": "Ripio secret key", "password": true }
  ],
  "servers": {
    "ripio": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "ripio-community-mcp"],
      "env": { "RIPIO_API_KEY": "${input:ripio-key}", "RIPIO_API_SECRET": "${input:ripio-secret}" }
    }
  }
}

Zed（settings.json）

{
  "context_servers": {
    "ripio": {
      "command": "npx",
      "args": ["-y", "ripio-community-mcp"],
      "env": { "RIPIO_API_KEY": "your-key", "RIPIO_API_SECRET": "your-secret" }
    }
  }
}

その他のMCPクライアント（Cline、Continue…）：コマンドにnpx、引数に-y ripio-community-mcp、以下の環境変数を指定して、stdio サーバーを追加します。設定場所については、お使いのクライアントのMCPドキュメントをご覧ください。また、公式のMCP Registryにもio.github.ruizemanuel/ripio-community-mcpとして掲載されているため、レジストリからインストールするクライアントで見つけられます。

Windows： サーバーが起動しない場合（たとえば「Connection closed」と表示される場合）は、cmd経由でnpxを起動してください。Claude Codeではコマンドの末尾に-- cmd /c npx -y ripio-community-mcpを指定します。JSON設定では、"command": "cmd"と"args": ["/c", "npx", "-y", "ripio-community-mcp"]を使用します。

設定

変数	必須	説明
RIPIO_API_KEY	はい	Ripio APIキー
RIPIO_API_SECRET	はい	Ripioシークレットキー
RIPIO_TRADE_RPS	いいえ	1秒あたりのRipio Tradeリクエスト数。デフォルトは1です。アカウントの書類が確認済みの場合は最大3.5です

セキュリティモデル

• 設計上、読み取り専用です。 HTTPクライアントはGETリクエストのみを送信でき、コードにそれ以外が含まれているとビルドに失敗するテストがあります。書き込み権限のあるキーであっても、このサーバーを通じて資金を移動することはできません。
• 接続先は1つのホストのみです。 https://api.ripio.comとのみ通信し、リダイレクトには従わないため、署名付きリクエストが別の場所に送信されることはありません。テレメトリーもありません。
• キーはお客様のもとに留まります。 キーは環境変数（Claude Desktopではキーチェーン）から読み込まれ、ログに記録されたり、モデルに送信されたりすることはありません。
• 最小権限を適用してください。 IP許可リストを設定した「Read-only」キーを使用してください。Ripio → Profile → APIから、いつでも取り消せます。
• 検証可能なビルドです。 npmリリースはprovenance付きでGitHub Actionsから公開されています。

脆弱性を見つけた場合は、SECURITY.mdをご覧ください。

制限事項

• RipioのAPIでは、カード取引、アプリ内での売買、請求書の支払いを取得できません。2026-07-21以降、それらはアクティビティフィードに表示されていません。
• Walletのアクティビティでは、from／toによってRipioが返すページを絞り込みます。古い項目を取得するにはnext_cursorをたどってください。ページの内容がfromより前にさかのぼると、それ以上のnext_cursorは提供されません。
• 値はRipioアプリの売却レートに基づく推定値であり、確定した価格ではありません。
• アルゼンチンのアカウントでテスト済みです。他の国でも読み取りはできる可能性がありますが、テストはされていません。
• Ripio Tradeでは、書類が確認済みでない場合、1秒あたり1件のリクエストが上限です。サーバーがリクエスト間隔を調整します。
• Ripio Tradeの明細は、一度に最大182日分まで読み取れます。さらに古い期間については、約6か月ごとに分けて問い合わせてください。
• 入金アドレスはRipioアプリ（Wallet）のアドレスです。Ripio Tradeの入金アドレスにはまだ対応していません。

開発

npm ci
npm test
npm run build

ご自身のアカウントでライブテストスイートを実行するには、読み取り専用キーの RIPIO_API_KEY と RIPIO_API_SECRET を記載した .env.live（Git の追跡対象外）を作成し、npm run test:live を実行してください。

コントリビューションを歓迎します。サーバーは読み取り専用に保ち、変更のたびにテストを追加してください。

免責事項

MIT ライセンスです。このプロジェクトは Ripio とは提携しておらず、推奨や支援も受けていません。商標はそれぞれの所有者に帰属します。ここに表示される情報はすべて参考用であり、金融アドバイスではありません。API キーの管理はご自身の責任で行ってください。