GoldBean MCP Server

🫘 GoldBean - x402 マイクロペイメント API マーケットプレイス

Base 上で USDC を使い、リクエストごとに支払います。登録不要、API キー不要、月額サブスクリプション不要です。 すべての呼び出しで、x402 プロトコルを通じて $0.02 USDC がかかります。

GoldBean は稼働中です： http://104.225.233.23:9879

---

クイックスタート

1. 前提条件

• Base 上の USDC（eip155:84532 テストネットまたは eip155:8453 メインネット）
• x402 支払いに署名できるウォレット（AgentCash、CDP Wallet、または任意の EVM ウォレット）

2. 無料エンドポイントを試す

curl http://104.225.233.23:9879/health
# {"status":"ok","service":"GoldBean","timestamp":"2026-05-15T12:00:00.000Z"}

curl http://104.225.233.23:9879/eth-price
# {"usd":"2255.93","change24h":"+0.31%","timestamp":"2026-05-15T12:00:00.000Z"}

3. 有料エンドポイントを呼び出す

curl http://104.225.233.23:9879/paid/btc-price
# HTTP 402 Payment Required
# x402-challenge: {...}

402 を支払ってデータを取得するには、x402 対応クライアントが必要です。

AgentCash を使う場合：

npx agentcash@latest fetch http://104.225.233.23:9879/paid/btc-price

x402-proxy（CLI ツール）を使う場合：

npx x402-proxy http://104.225.233.23:9879/paid/btc-price

手動支払いで curl を使う場合（上級者向け）：

# Step 1: Request triggers 402
curl -s -D - http://104.225.233.23:9879/paid/btc-price

# Step 2: Parse x402-challenge header, sign with your wallet
# Step 3: Retry with x402-payment header
curl -H "x402-payment: <signed-payment>" http://104.225.233.23:9879/paid/btc-price

4. MCP 統合

Claude Desktop / Cursor / Cline の mcpServers 設定に追加します。

{
  "mcpServers": {
    "goldbean": {
      "url": "http://104.225.233.23:9879/mcp"
    }
  }
}

---

利用可能なエンドポイント

無料（支払い不要）

エンドポイント	説明
GET /	サービス情報とエンドポイント一覧
GET /health	ヘルスチェック
GET /eth-price	ETH のリアルタイム価格（CoinGecko 経由）
GET /gas	ETH のガス価格の推定値
GET /card	サービスカード／メタデータ
GET /mcp	MCP プロトコルマニフェスト

有料（呼び出しごとに $0.02 USDC）

エンドポイント	説明
GET /paid/btc-price	BTC のリアルタイム価格（CoinGecko 経由）
GET /paid/gas-forecast	ガス価格の予測
GET /paid/market-intel	市場センチメントと Fear & Greed Index
GET /paid/defi-insights	DeFi TVL とチェーンデータ
GET /paid/network-health	ブロックチェーンネットワークの健全性
GET /paid/tracker-report	MEV とオンチェーントラッカーのレポート
GET /paid/sol-token-risk	Solana トークンのリスク評価

---

x402 支払いの仕組み

Client                          GoldBean Server
  │                                   │
  ├─ GET /paid/btc-price ─────────────┤
  │◄─ 402 Payment Required ───────────┤
  │   x402-challenge: {...}           │
  │                                   │
  ├─ Sign challenge with wallet ──────┤
  │   (off-chain, no gas fee)         │
  │                                   │
  ├─ GET /paid/btc-price ─────────────┤
  │   x402-payment: <signed>          │
  │◄─ 200 OK ─────────────────────────┤
  │   {"usd":"68000.00",...}          │
  │                                   │

ファシリテーター（x402.org）が決済を処理します。チャレンジが受け入れられた場合にのみ、ウォレットから USDC が送金されます。継続課金はありません。

---

データソース

• CoinGecko API — 暗号資産のリアルタイム価格
• Etherscan API — ガス価格オラクル
• Alternative.me — Fear & Greed Index

---

販売者情報

• 販売者のウォレット： 0xB5f5CBe48E0595C044Bc626f278F757463eAc2Ce（Base）
• ネットワーク： eip155:84532（Base Sepolia テストネット）→ eip155:8453（Base メインネット）へ移行予定
• ファシリテーター： https://x402.org/facilitator
• 価格： 有料呼び出しごとに $0.02 USDC

---

アーキテクチャ

┌─────────────┐     x402 protocol      ┌──────────────┐
│   Client    │ ◄─────────────────────► │   VPS (USCA) │
│ (curl/Agent)│     HTTP + 402 flow     │  GoldBean 🫘 │
└─────────────┘                         │  :9879       │
       │                                └──────┬───────┘
       │         ┌──────────────┐              │
       └────────►│    Email     │◄─────────────┘
                 │  (Gmail)     │  Monitor alerts
                 │   Monitor    │
                 └──────────────┘

---

開発

# Server
cd /opt/goldbean
npm install express axios @x402/express @x402/core @x402/evm
node server.js

# Monitor
python3 /opt/goldbean/chain_monitor.py

---

エコシステム

• x402 Foundation
• Awesome x402
• x402 TypeScript SDK

---

Bandwagon VPS（USCA-2）上に構築されています。x402 エコシステムの一部です。