Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP server for Pear Protocol: markets, positions, orders, portfolio, and gated trade execution.
一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり
| 人気 | 4/80 | GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます |
|---|---|---|
| 新しさ | 3/12 | 30 日以内のリリースかコード更新で満点 |
| 応答中 | 0/8 | 前回の確認でクラウドのエンドポイントが応答 |
| 利用スコア | 7/100 |
品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)
使っているAIアプリを選んで、設定をコピーしてください。
ひとことで AI にインストールしてもらう
MCP Pear をインストールして。https://mcp.popnx.com/i/marvelnwachukwu-mcp-pear.md に従い、コマンドを見せて、私が OK するまで実行しないで。パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る
チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日
まず:どの AI を使っていますか?
使っているアプリを選ぶと、下に手順が表示されます。
Claude につなげますが、先に準備が必要です
MCP Pear のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (PEAR_ADDRESS) · 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude に MCP server MCP Pear を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "pear": { "command": "npx", "args": [ "-y", "@marvelcodes/mcp-pear" ], "env": { "PEAR_API_KEY": "your-value", "PEAR_ADDRESS": "your-value", "PEAR_REFRESH_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) PEAR_API_KEY, PEAR_REFRESH_TOKEN, PEAR_ADDRESS は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Pear のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
PEAR_ADDRESS PEAR_API_KEY に紐づくウォレットアドレス(0x...)。PEAR_API_KEY と併せて必要です。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
SettingsDeveloperEdit Config
{
"mcpServers": {
"pear": {
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "your-value",
"PEAR_ADDRESS": "your-value",
"PEAR_REFRESH_TOKEN": "your-value"
}
}
}
}キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
MCP Pear を使って、私に何ができるか教えて、1 つやってみせて✓ Claude が MCP Pear を使っていると言うか、回答に MCP Pear のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
PEAR_JWT マルチテナントのオーケストレーター向けに事前発行された Pear JWT(JWT パススルーモード)。設定されている場合はそのまま使用されます。 PEAR_TRADE_ENABLED 'true' に設定すると、書き込み/取引実行ツールを有効にします。デフォルトではオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
ChatGPT はまだ MCP Pear につなげません
MCP Pear はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません
A · MCP Pear につなげるアプリを使う
B · ネットショップ・決済 の中で ChatGPT につなげる別のサーバー
同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました
Claude Code につなげますが、先に準備が必要です
MCP Pear のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (PEAR_ADDRESS) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Claude Code に MCP server MCP Pear を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user pear --env PEAR_API_KEY=your-value --env PEAR_ADDRESS=your-value --env PEAR_REFRESH_TOKEN=your-value -- npx -y @marvelcodes/mcp-pear 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) PEAR_API_KEY, PEAR_REFRESH_TOKEN, PEAR_ADDRESS は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Pear のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
PEAR_ADDRESS PEAR_API_KEY に紐づくウォレットアドレス(0x...)。PEAR_API_KEY と併せて必要です。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く
claude mcp add --scope user pear --env PEAR_API_KEY=your-value --env PEAR_ADDRESS=your-value --env PEAR_REFRESH_TOKEN=your-value -- npx -y @marvelcodes/mcp-pearEnter の前に「your-value」を自分のキーに書き換えてください
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
MCP Pear が一覧にあり、接続済みと表示されれば OK です
MCP Pear を使って、私に何ができるか教えて、1 つやってみせて✓ Claude Code が MCP Pear を使っていると言うか、回答に MCP Pear のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
PEAR_JWT マルチテナントのオーケストレーター向けに事前発行された Pear JWT(JWT パススルーモード)。設定されている場合はそのまま使用されます。 PEAR_TRADE_ENABLED 'true' に設定すると、書き込み/取引実行ツールを有効にします。デフォルトではオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Cursor につなげますが、先に準備が必要です
MCP Pear のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (PEAR_ADDRESS) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの Cursor に MCP server MCP Pear を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "pear": { "command": "npx", "args": [ "-y", "@marvelcodes/mcp-pear" ], "env": { "PEAR_API_KEY": "your-value", "PEAR_ADDRESS": "your-value", "PEAR_REFRESH_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) PEAR_API_KEY, PEAR_REFRESH_TOKEN, PEAR_ADDRESS は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Pear のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
PEAR_ADDRESS PEAR_API_KEY に紐づくウォレットアドレス(0x...)。PEAR_API_KEY と併せて必要です。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
MCP Pear の設定で PEAR_API_KEY, PEAR_REFRESH_TOKEN, PEAR_ADDRESS が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
MCP Pear を使って、私に何ができるか教えて、1 つやってみせて✓ Cursor が MCP Pear を使っていると言うか、回答に MCP Pear のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
PEAR_JWT マルチテナントのオーケストレーター向けに事前発行された Pear JWT(JWT パススルーモード)。設定されている場合はそのまま使用されます。 PEAR_TRADE_ENABLED 'true' に設定すると、書き込み/取引実行ツールを有効にします。デフォルトではオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
VS Code につなげますが、先に準備が必要です
MCP Pear のキーが必要です(提供元のサイトで作成) · 設定を 1 項目入力 (PEAR_ADDRESS) · 先にパソコンへ Node.js を入れてください(1 回だけ)
このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。
このパソコンの VS Code に MCP server MCP Pear を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "pear": { "type": "stdio", "command": "npx", "args": [ "-y", "@marvelcodes/mcp-pear" ], "env": { "PEAR_API_KEY": "your-value", "PEAR_ADDRESS": "your-value", "PEAR_REFRESH_TOKEN": "your-value" } } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) PEAR_API_KEY, PEAR_REFRESH_TOKEN, PEAR_ADDRESS は "your-value" のままにして、本当の値は私がファイルかアプリの入力欄に自分で貼るよう伝える。チャットにキーを書かせない。5) 了承した内容を実行し、MCP Pear のツールが本当に表示されるか確認する。このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。
もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter
node -vMac:⌘ + Space を押し、Terminal と入力して Enter
Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」
まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です
入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v
一度入れれば、Node.js を使うすべてのツールで使えます
提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。
キーの取り方は下の提供元 README にあります
これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。
PEAR_ADDRESS PEAR_API_KEY に紐づくウォレットアドレス(0x...)。PEAR_API_KEY と併せて必要です。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
MCP Pear の設定で PEAR_API_KEY, PEAR_REFRESH_TOKEN, PEAR_ADDRESS が空です。自分のキーを入れて保存します
キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください
MCP Pear を使って、私に何ができるか教えて、1 つやってみせて✓ VS Code が MCP Pear を使っていると言うか、回答に MCP Pear のツール名が出れば接続成功です
上のコマンドはこれらがなくても動きます。変えたいときだけ作者の説明に沿って追加してください。
PEAR_JWT マルチテナントのオーケストレーター向けに事前発行された Pear JWT(JWT パススルーモード)。設定されている場合はそのまま使用されます。 PEAR_TRADE_ENABLED 'true' に設定すると、書き込み/取引実行ツールを有効にします。デフォルトではオフです。 説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります
Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください
JSON 設定は下の「開発者向け」にあります
Claude Code
claude mcp add --scope user pear --env PEAR_API_KEY=your-value --env PEAR_ADDRESS=your-value --env PEAR_REFRESH_TOKEN=your-value -- npx -y @marvelcodes/mcp-pearClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"pear": {
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "your-value",
"PEAR_ADDRESS": "your-value",
"PEAR_REFRESH_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"pear": {
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "your-value",
"PEAR_ADDRESS": "your-value",
"PEAR_REFRESH_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"pear": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@marvelcodes/mcp-pear"
],
"env": {
"PEAR_API_KEY": "your-value",
"PEAR_ADDRESS": "your-value",
"PEAR_REFRESH_TOKEN": "your-value"
}
}
}
}PEAR_API_KEY 秘密 必須 envPEAR_ADDRESS 必須 envPEAR_JWT 秘密 envPEAR_REFRESH_TOKEN 秘密 必須 envPEAR_TRADE_ENABLED env説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。
この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。
このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。
パソコン上で動かせるアプリ
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。
誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック
レジストリ名は、リポジトリを所有するGitHubアカウント MarvelNwachukwu で確認済みです
コードの最終更新:4 か月前
MITを使用
これはパソコンで動くため、インターネット上のエンドポイントはありません
パソコンで動き、代わりにローカルの設定を使います
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです
OSV.dev に @marvelcodes/mcp-pear@0.2.2 の登録はありません
このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日
作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。
[](https://mcp.popnx.com/en/servers/marvelnwachukwu-mcp-pear)質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。
まだレビューはありません
レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。
当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。
入力が必要なもの:PEAR_API_KEY, PEAR_REFRESH_TOKEN
あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。
GitHubリポジトリの最終更新は4 か月前、最新バージョン(0.2.2)がレジストリに届いたのは4 か月前です。
Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。
同じカテゴリには:Stripe MCP, flightclaw, Trade It, Marketplace Ad Pros: Amazon Ads & Seller Central, idealo MCP Server
同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。
カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Search ~300 airlines and book flights with a checkout link. OAuth sign-in by email code.
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Amazon Ads, Seller Central, Vendor Central and AMC data for AI agents. Read-only by default.
Search products, compare prices and discover deals across 6 European markets with your AI assistant.
| これ MCP Pear | Stripe MCP | flightclaw | Trade It | Marketplace Ad Pros: Amazon Ads & Seller Central | idealo MCP Server | |
|---|---|---|---|---|---|---|
| 動く場所 | パソコンにインストールが必要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 | クラウドで動き、インストール不要 |
| キーが必要 | はい | いいえ | いいえ | いいえ | いいえ | いいえ |
| Claude で + から追加 | いいえ | はい | いいえ | いいえ | いいえ | いいえ |
| 基本チェック | 3/3 | 4/4 | 4/4 | 5/5 | 4/4 | 4/4 |
| ライセンス | MIT | MIT | MIT | CC0-1.0 | MIT | MIT |
| 料金 | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし | 登録情報に費用の記載なし |
作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。
The Pear Protocol MCP server for Hyperliquid pair trading — connect Claude, Cursor, or any AI agent to on-chain perps: browse pair markets, read positions and portfolio, and (opt-in) execute pair trades.
Model Context Protocol (MCP) server for Pear Protocol. Gives Claude, or any MCP-compatible agent, access to markets, pair ratios, positions, orders, trade history, portfolio, and (v0.2) full trade execution on Hyperliquid.
v0.2 adds trade execution. Ten write tools (open, close, and adjust positions; manage leverage and risk; cancel orders) are off by default behind
PEAR_TRADE_ENABLED=true. Pear signs server-side, so mcp-pear never holds private keys.
Pear is a Hyperliquid-backed perps platform for pair markets: long one basket against another. Every pair has a live ratio that moves as the legs diverge. More at pearprotocol.io.
Public (no auth):
get_health: API health and uptimelist_markets: browse pair markets with filters and paginationget_active_markets: top gainers, losers, and highlighted pairsget_pair_ratio: current ratio, 24h change, and funding for a specific pairAuthenticated read:
get_account_summary: your account headerget_open_positions: your open positions with PnLget_open_orders: your open limit, TP, and SL ordersget_twap_orders: your active TWAP ordersget_trade_history: your closed trades with realized PnLget_portfolio: bucketed PnL across 1d, 1w, 1m, 1y, and all-timeget_agent_wallet: the agent wallet Pear uses to sign your tradesAuthenticated write (v0.2, gated behind PEAR_TRADE_ENABLED=true):
create_agent_wallet: create the agent walletopen_position, close_position, close_all_positions: open and close pair positionsadjust_position, adjust_leverage: change size or leverage on a live positionset_risk_parameters: set or update TP and SLcancel_order, cancel_twap_order: cancel pending ordersFull parameter reference in Tool reference. See Trade execution (v0.2) for the gate and Hyperliquid funding rules.
# Run directly
npx -y @marvelcodes/mcp-pear@latest
pnpm install -g @marvelcodes/mcp-pear mcp-pear
Pin `@latest` (or a specific version) in the npx spec. Plain
npx @marvelcodes/mcp-pearcan launch a stale cached version: npx prefers its local cache over the npm registry when the spec is unpinned, so after a new release lands you may still be running the old one.@latestre-resolves against the registry each launch; pin like@0.2.0instead if you want a frozen version. Stuck on an old version after upgrading? Clear the npx cache:rm -rf ~/.npm/_npx(macOS/Linux).
For the authenticated tools, mint a key:
npx -y @marvelcodes/mcp-pear@latest setup
The CLI opens a browser, asks you to sign once with your wallet, mints a Pear API key, and (optionally) writes PEAR_API_KEY and PEAR_ADDRESS to a .env. Copy those two values into your Claude Desktop config and restart Claude.
Already have a JWT from
app.pear.garden? Skipsetupand use JWT pass-through below.
Three auth modes. mcp-pear uses the first one whose env vars are set, decided on the first authenticated call.
For Telegram bots and other orchestrators that mint JWTs externally (Privy, EIP-712, or any Pear-supported flow). The JWT is opaque; mcp-pear never calls /auth/login.
| Env var | Required | Description |
|---|---|---|
PEAR_JWT | yes | Pre-minted access token. Used directly when set. PEAR_API_KEY and PEAR_ADDRESS act as fallback if the JWT expires and no PEAR_REFRESH_TOKEN is configured. |
PEAR_REFRESH_TOKEN | no | If set, mcp-pear refreshes the JWT itself when it expires mid-session (each refresh rotates the token). Without it, the orchestrator has to re-mint and respawn the subprocess. |
When PEAR_JWT expires and no refresh token is set, authenticated tools return:
JWT expired; the orchestrator must mint a new one and restart mcp-pear.
See examples/telegram-bot-usage.ts for the orchestrator pattern.
| Env var | Required | Description |
|---|---|---|
PEAR_API_KEY | for auth tools | Your Pear API key. |
PEAR_ADDRESS | for auth tools | Wallet address bound to the API key (0x...). |
mcp-pear mints the JWT itself by calling POST /auth/login. Both fields are required: the OpenAPI spec needs address in the request body.
The four public tools work without any auth env vars. Authenticated tools return a ConfigError naming the missing env var.
| Env var | Default | Description |
|---|---|---|
PEAR_API_BASE_URL | https://hl-v2.pearprotocol.io | Pear API host. |
PEAR_API_TIMEOUT_MS | 10000 | Per-request timeout. |
PEAR_CLIENT_ID | APITRADER | Client identifier sent to /auth/login. |
Add to claude_desktop_config.json:
{
"mcpServers": { "pear": { "command": "npx", "args": ["-y", "@marvelcodes/mcp-pear@latest"], "env": { "PEAR_API_KEY": "your-pear-api-key-here", "PEAR_ADDRESS": "0xYourWalletAddress" } } } }
Restart Claude Desktop and ask: "Use Pear to show me the top active markets right now."
import { McpToolset, StdioTransport } from "@iqai/adk";
const pearTools = new McpToolset({ transport: new StdioTransport({ command: "npx", args: ["-y", "@marvelcodes/mcp-pear@latest"], env: { PEAR_API_KEY: process.env.PEAR_API_KEY ?? "", PEAR_ADDRESS: process.env.PEAR_ADDRESS ?? "" }, }), });
await pearTools.connect(); const tools = await pearTools.listTools();
Full example in examples/adk-ts-usage.ts.
adjust_leverageChange leverage (1-100x) on an existing Pear Protocol position. Higher leverage means greater liquidation risk for the same price move. WRITE: changes risk profile of a live position. Requires PEAR_TRADE_ENABLED=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
positionId | string | yes | |
leverage | integer | yes |
adjust_positionReduce or increase an existing Pear Protocol position's size by 1-100 percent. executionType: MARKET (immediate) or LIMIT (provide limitRatio). WRITE: changes exposure on a real trade. Requires PEAR_TRADE_ENABLED=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
positionId | string | yes | |
adjustmentType | string | yes | |
adjustmentSize | integer | yes | |
executionType | string | yes | |
limitRatio | number | ||
referralCode | string |
cancel_orderCancel a pending Pear Protocol limit, take-profit, or stop-loss order by orderId. Does not affect already-filled portions. For TWAP orders, use cancel_twap_order. WRITE: cancels a live order. Requires PEAR_TRADE_ENABLED=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
orderId | string | yes |
cancel_twap_orderCancel a Pear Protocol TWAP (time-weighted average price) order and all of its remaining unfilled chunks. WRITE: cancels a live order. Requires PEAR_TRADE_ENABLED=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
orderId | string | yes |
close_all_positionsClose every open Pear Protocol position with a single executionType (MARKET or TWAP). Returns a per-position result array with success/error. WRITE: executes real trades. Requires PEAR_TRADE_ENABLED=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
executionType | string | yes | |
twapDuration | number | ||
twapIntervalSeconds | number | ||
randomizeExecution | boolean | ||
referralCode | string |
close_positionClose one open Pear Protocol position by positionId. executionType: MARKET (immediate) or TWAP (spread over time; requires twapDuration in seconds). WRITE: executes a real trade. Requires PEAR_TRADE_ENABLED=true.
| Parameter | Type | Required | Description |
|---|---|---|---|
positionId | string | yes | |
executionType | string | yes | |
twapDuration | number | ||
twapIntervalSeconds | number | ||
randomizeExecution | boolean | ||
referralCode | string |
create_agent_walletCreate a new Pear Protocol agent wallet for the authenticated user. The agent wallet is what Pear uses to sign Hyperliquid trades. After creation, the user MUST approve this wallet on Hyperliquid (the response message contains the approval instructions). WRITE: executes a state change. Requires PEAR_TRADE_ENABLED=true.
_No parameters_
get_account_summaryGet the authenticated user's Pear Protocol account summary: agent wallet address, total closed trades, pending trigger-order USD value, pending TWAP-chunk USD value, and last sync timestamp. Requires PEAR_API_KEY.
_No parameters_
get_active_marketsGet the most active Pear Protocol pair markets right now: current active pairs plus top gainers, top losers, highlighted pairs, and the user's watchlist. Use to see what's hot or as a starting point for narrowing into a specific pair.
_No parameters_
get_agent_walletGet the authenticated user's Pear Protocol agent wallet address. The agent wallet is what Pear uses to sign Hyperliquid trades on the user's behalf. Returns an empty/missing address if no agent wallet has been created yet; call create_agent_wallet to create one.
_No parameters_
get_healthCheck Pear Protocol API health. Returns service status, server timestamp, and uptime in seconds. Use this to verify the API is reachable before running other tools.
_No parameters_
get_open_ordersList the authenticated user's open limit, take-profit, and stop-loss orders on Pear Protocol. Returns each order's ID, type, status, and pair composition. Requires PEAR_API_KEY.
_No parameters_
get_open_positionsList the authenticated user's currently open Pear Protocol pair positions, including position ID, entry ratio, mark ratio, unrealized PnL, and long/short composition. Requires PEAR_API_KEY.
_No parameters_
get_pair_ratioGet the current ratio (long/short composition price) for a specific Pear Protocol pair. Pass long and short asset arrays. Returns the ratio, 24h change, and funding rate. Useful when you know the pair you care about and want the latest number.
| Parameter | Type | Required | Description |
|---|---|---|---|
longAssets | array | yes | Asset symbols on the long side (e.g. ['BTC']). |
shortAssets | array | yes | Asset symbols on the short side. Pass an empty array for long-only baskets. |
get_portfolioFetch the authenticated user's full portfolio metrics on Pear Protocol: bucketed PnL across last 1 day / 1 week / 1 month / 1 year / all-time, plus overall stats (total trades, all-time volume, current open interest, unrealized PnL). Requires PEAR_API_KEY.
_No parameters_
get_trade_historyFetch the authenticated user's recent closed trades on Pear Protocol with realized PnL, entry/exit ratios, and pair composition. Optional date range and limit. Requires PE