English Français العربية

GoldBean MCP Server

Official registry Search and web

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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.

Frequently asked questions

What is GoldBean MCP Server?

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

How do I install GoldBean MCP Server?

It runs on your machine. In Claude Code: claude mcp add goldbean-mcp-server -- npx -y goldbean-mcp -y goldbean-mcp@0.3.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does GoldBean MCP Server need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is GoldBean MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains GoldBean MCP Server?

It is published by wuzenghai616-lang. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.