{
  "markdown": "# 🫘 GoldBean - x402 Micropaid API Marketplace\n\n[![Official MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.wuzenghai616--lang%2Fgoldbean-blue)](https://github.com/wuzenghai616-lang/goldbean)\n[![npm](https://img.shields.io/npm/v/goldbean-mcp)](https://npmjs.com/goldbean-mcp)\n\n> Pay per request with USDC on Base. No signup, no API key, no monthly subscription.\n> Every call costs $0.02 USDC via the [x402](https://x402.org) protocol.\n\n**GoldBean is live:** `http://104.225.233.23:9879`\n\n---\n\n## Quick Start\n\n### 1. Prerequisites\n\n- **USDC on Base** (`eip155:84532` testnet or `eip155:8453` mainnet)\n- **A wallet** that can sign x402 payments (AgentCash, CDP Wallet, or any EVM wallet)\n\n### 2. Try a Free Endpoint\n\n```bash\ncurl http://104.225.233.23:9879/health\n# {\"status\":\"ok\",\"service\":\"GoldBean\",\"timestamp\":\"2026-05-15T12:00:00.000Z\"}\n\ncurl http://104.225.233.23:9879/eth-price\n# {\"usd\":\"2255.93\",\"change24h\":\"+0.31%\",\"timestamp\":\"2026-05-15T12:00:00.000Z\"}\n```\n\n### 3. Call a Paid Endpoint\n\n```bash\ncurl http://104.225.233.23:9879/paid/btc-price\n# HTTP 402 Payment Required\n# x402-challenge: {...}\n```\n\nTo pay the 402 and get data, you need an x402-capable client:\n\n**Using AgentCash:**\n```bash\nnpx agentcash@latest fetch http://104.225.233.23:9879/paid/btc-price\n```\n\n**Using x402-proxy (CLI tool):**\n```bash\nnpx x402-proxy http://104.225.233.23:9879/paid/btc-price\n```\n\n**Using curl with manual payment (advanced):**\n```bash\n# Step 1: Request triggers 402\ncurl -s -D - http://104.225.233.23:9879/paid/btc-price\n\n# Step 2: Parse x402-challenge header, sign with your wallet\n# Step 3: Retry with x402-payment header\ncurl -H \"x402-payment: <signed-payment>\" http://104.225.233.23:9879/paid/btc-price\n```\n\n### 4. MCP Integration\n\nAdd to Claude Desktop / Cursor / Cline `mcpServers` config:\n\n```json\n{\n  \"mcpServers\": {\n    \"goldbean\": {\n      \"url\": \"http://104.225.233.23:9879/mcp\"\n    }\n  }\n}\n```\n\n---\n\n## Available Endpoints\n\n### Free (no payment needed)\n\n| Endpoint | Description |\n|----------|-------------|\n| `GET /` | Service info & endpoint list |\n| `GET /health` | Health check |\n| `GET /eth-price` | Real-time ETH price (via CoinGecko) |\n| `GET /gas` | ETH gas price estimate |\n| `GET /card` | Service card / metadata |\n| `GET /mcp` | MCP protocol manifest |\n\n### Paid ($0.02 USDC per call)\n\n| Endpoint | Description |\n|----------|-------------|\n| `GET /paid/btc-price` | Real-time BTC price (via CoinGecko) |\n| `GET /paid/gas-forecast` | Gas price forecast |\n| `GET /paid/market-intel` | Market sentiment & Fear & Greed Index |\n| `GET /paid/defi-insights` | DeFi TVL & chain data |\n| `GET /paid/network-health` | Blockchain network health |\n| `GET /paid/tracker-report` | MEV & on-chain tracker report |\n| `GET /paid/sol-token-risk` | Solana token risk assessment |\n\n---\n\n## How x402 Payment Works\n\n```\nClient                          GoldBean Server\n  │                                   │\n  ├─ GET /paid/btc-price ─────────────┤\n  │◄─ 402 Payment Required ───────────┤\n  │   x402-challenge: {...}           │\n  │                                   │\n  ├─ Sign challenge with wallet ──────┤\n  │   (off-chain, no gas fee)         │\n  │                                   │\n  ├─ GET /paid/btc-price ─────────────┤\n  │   x402-payment: <signed>          │\n  │◄─ 200 OK ─────────────────────────┤\n  │   {\"usd\":\"68000.00\",...}          │\n  │                                   │\n```\n\nThe facilitator (`x402.org`) handles settlement. Your wallet sends USDC only when challenge is accepted. No recurring charges.\n\n---\n\n## Data Sources\n\n- **CoinGecko API** — Real-time cryptocurrency prices\n- **Etherscan API** — Gas price oracle\n- **Alternative.me** — Fear & Greed Index\n\n---\n\n## Seller Info\n\n- **Seller wallet:** `0xB5f5CBe48E0595C044Bc626f278F757463eAc2Ce` (Base)\n- **Network:** `eip155:84532` (Base Sepolia testnet) → migrating to `eip155:8453` (Base mainnet)\n- **Facilitator:** `https://x402.org/facilitator`\n- **Price:** $0.02 USDC per paid call\n\n---\n\n## Architecture\n\n```\n┌─────────────┐     x402 protocol      ┌──────────────┐\n│   Client    │ ◄─────────────────────► │   VPS (USCA) │\n│ (curl/Agent)│     HTTP + 402 flow     │  GoldBean 🫘 │\n└─────────────┘                         │  :9879       │\n       │                                └──────┬───────┘\n       │         ┌──────────────┐              │\n       └────────►│    Email     │◄─────────────┘\n                 │  (Gmail)     │  Monitor alerts\n                 │   Monitor    │\n                 └──────────────┘\n```\n\n---\n\n## Development\n\n```bash\n# Server\ncd /opt/goldbean\nnpm install express axios @x402/express @x402/core @x402/evm\nnode server.js\n\n# Monitor\npython3 /opt/goldbean/chain_monitor.py\n```\n\n---\n\n## Ecosystem\n\n- [x402 Foundation](https://x402.org)\n- [Awesome x402](https://github.com/Merit-Systems/awesome-x402)\n- [x402 TypeScript SDK](https://github.com/x402-foundation/x402)\n\n---\n\n*Built on Bandwagon VPS (USCA-2). Part of the x402 ecosystem.*\n",
  "bytes": 4949,
  "sha": "ad8f6ad25a412f3c67c1cfc228e499f5ff4ecc9d31707e9e731c1d7f046596d5",
  "repo_slug": "wuzenghai616-lang/goldbean",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_wuzenghai616_lang_goldbean_81287fcb/readme"
}