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 Gas 价格估算
GET /card	服务卡片 / 元数据
GET /mcp	MCP 协议清单

付费（每次调用 $0.02 USDC）

端点	描述
GET /paid/btc-price	BTC 实时价格（通过 CoinGecko）
GET /paid/gas-forecast	Gas 价格预测
GET /paid/market-intel	市场情绪和恐惧与贪婪指数
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 — Gas 价格预言机
• Alternative.me — 恐惧与贪婪指数

---

卖家信息

• 卖家钱包： 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 生态系统。