English Français العربية

GoldBean MCP Server

Registre officiel Recherche et web

49 pay-per-use APIs for AI agents via x402. AI, crypto, DeFi, blockchain, weather, search, security.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package goldbean-mcp
Claude Code 
claude mcp add goldbean-mcp-server -- npx -y goldbean-mcp -y goldbean-mcp@0.3.3
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "goldbean-mcp-server": {
            "command": "npx -y goldbean-mcp",
            "args": [
                "-y",
                "goldbean-mcp@0.3.3"
            ]
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. 🫘 GoldBean - x402 Micropaid API Marketplace
  2. Quick Start
  3. Available Endpoints
  4. How x402 Payment Works
  5. Data Sources
  6. Seller Info
  7. Architecture
  8. Development
  9. Ecosystem

🫘 GoldBean - x402 Micropaid API Marketplace

Pay per request with USDC on Base. No signup, no API key, no monthly subscription. Every call costs $0.02 USDC via the x402 protocol.

GoldBean is live: http://104.225.233.23:9879

Quick Start

1. Prerequisites
  • USDC on Base (eip155:84532 testnet or eip155:8453 mainnet)
  • A wallet that can sign x402 payments (AgentCash, CDP Wallet, or any EVM wallet)
2. Try a Free Endpoint
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. Call a Paid Endpoint
curl http://104.225.233.23:9879/paid/btc-price
# HTTP 402 Payment Required
# x402-challenge: {...}

To pay the 402 and get data, you need an x402-capable client:

Using AgentCash:

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

Using x402-proxy (CLI tool):

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

Using curl with manual payment (advanced):

# 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 Integration

Add to Claude Desktop / Cursor / Cline mcpServers config:

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

Available Endpoints

Free (no payment needed)
EndpointDescription
GET /Service info & endpoint list
GET /healthHealth check
GET /eth-priceReal-time ETH price (via CoinGecko)
GET /gasETH gas price estimate
GET /cardService card / metadata
GET /mcpMCP protocol manifest
Paid ($0.02 USDC per call)
EndpointDescription
GET /paid/btc-priceReal-time BTC price (via CoinGecko)
GET /paid/gas-forecastGas price forecast
GET /paid/market-intelMarket sentiment & Fear & Greed Index
GET /paid/defi-insightsDeFi TVL & chain data
GET /paid/network-healthBlockchain network health
GET /paid/tracker-reportMEV & on-chain tracker report
GET /paid/sol-token-riskSolana token risk assessment

How x402 Payment Works

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",...}          │
  │                                   │

The facilitator (x402.org) handles settlement. Your wallet sends USDC only when challenge is accepted. No recurring charges.

Data Sources

  • CoinGecko API — Real-time cryptocurrency prices
  • Etherscan API — Gas price oracle
  • Alternative.me — Fear & Greed Index

Seller Info

  • Seller wallet: 0xB5f5CBe48E0595C044Bc626f278F757463eAc2Ce (Base)
  • Network: eip155:84532 (Base Sepolia testnet) → migrating to eip155:8453 (Base mainnet)
  • Facilitator: https://x402.org/facilitator
  • Price: $0.02 USDC per paid call

Architecture

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

Development

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

# Monitor
python3 /opt/goldbean/chain_monitor.py

Ecosystem

Built on Bandwagon VPS (USCA-2). Part of the x402 ecosystem.

Questions fréquentes

Qu'est-ce que GoldBean MCP Server ?

49 pay-per-use APIs for AI agents via x402. AI, crypto, DeFi, blockchain, weather, search, security.

Comment installer GoldBean MCP Server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add goldbean-mcp-server -- npx -y goldbean-mcp -y goldbean-mcp@0.3.3. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour GoldBean MCP Server ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

GoldBean MCP Server est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient GoldBean MCP Server ?

Il est publié par wuzenghai616-lang. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.