Goldbean MCP Server

🫘 GoldBean — Payment-Powered AI API Gateway

Access Baidu AI (OCR, Translation, TTS, ASR, LLM) from anywhere — no Chinese phone number required

GoldBean is a pay-per-use AI API gateway. Access Baidu AI products (OCR, TTS, ASR, Translation, NLP, Face Detection, Image Analysis) and HelixFold3 protein structure prediction — all through a unified API with x402 USDC micropayments.

x402 is the open standard for crypto micropayments over HTTP. Learn more at x402.org

No subscription. No KYC. Pay cents per call.

---

✨ Features

---

🤔 Why GoldBean?

Need Baidu OCR but don't have a Chinese phone number?

GoldBean is the easiest way for overseas developers to use Baidu AI APIs without a Chinese phone number, real-name verification, or WeChat Pay.

• ✅ Use Baidu API without registration — no Chinese ID, no real-name auth
• ✅ Baidu OCR API without Chinese phone — just sign up with any email
• ✅ No KYC, no subscription — pay cents per call via USDC, PayPal, or Alipay
• ✅ Free credits to start — 20 free API calls, no wallet required
• ✅ Works globally — no mainland China restrictions for foreign users

Whether you need Baidu OCR for document scanning, Baidu Translation for multilingual text, or Baidu ASR/TTS for voice processing — GoldBean unlocks it all without the registration barriers.

---

🚀 Quick Start

1. Install the MCP Server

npx goldbean-mcp

2. Add to Your MCP Client

Claude Desktop / Cursor / Continue:

{
  "mcpServers": {
    "goldbean": {
      "command": "npx",
      "args": ["goldbean-mcp"]
    }
  }
}

3. Use Free Credits (No Wallet)

# Register for 20 free API calls
curl -X POST https://goldbean-api.xyz/paid/user/register \
  -H "Content-Type: application/json" \
  -d '{"userId": "your-user-id"}'

# Response: {"freeCredits": 20, "apiKey": "GB_XXXXXX"}

# Call an API with free credits
curl "https://goldbean-api.xyz/paid/baidu-ocr?image=https://example.com/doc.jpg" \
  -H "x-user-id: GB_XXXXXX"

---

📚 Code Examples

We provide ready-to-use code examples in the examples/ directory:

git clone https://github.com/wuzenghai616-lang/goldbean.git
cd goldbean/examples

# Python: Install deps and run
pip install mcp web3
python python-integration.py

# Node.js: Install deps and run
npm install @modelcontextprotocol/sdk @goldbean/x402-sdk
node nodejs-x402-example.js

---

📡 API Endpoints

🆓 Free System Endpoints

🎯 Baidu AI Endpoints (Pay-per-Call)

💳 Account & Payment

---

💰 How x402 Payments Work

1. Agent calls endpoint → 402 Payment Required
2. Wallet signs USDC tx on Base → sends payment payload
3. Server verifies on-chain → serves the data

No KYC. No subscription. No credit card required.

Powered by the x402 protocol — decentralized micropayments for AI agents.

Accepting wallet: 0x7484b0bca25d2ee56e9b0535572d4cf44a047d98 (Base/USDC)

---

🏗️ Architecture

┌──────────────┐    HTTPS    ┌──────────────────────┐
│  MCP Client   │ ──────────→ │  GoldBean API Server  │
│  (Claude,     │ ←────────── │  v8.0.0 on VPS       │
│   Cursor,     │    402/200  │  port 9879            │
│   Cline)      │             │                      │
└──────────────┘             ├── Baidu AI (OCR/TTS)  │
                              ├── CoinGecko (BTC)     │
┌──────────────┐             ├── Etherscan (Gas)     │
│  Web Browser  │──────────→ │── HelixFold3          │
│  (curl/REST)  │             │── PayPal/Alipay       │
└──────────────┘             └──────────────────────┘

---

🏆 Platform Presence

---

📖 Documentation

• API Reference: https://goldbean-api.xyz/openapi.json
• Route Registry: https://goldbean-api.xyz/api/routes
• x402 Bazaar: https://goldbean-api.xyz/.well-known/x402-bazaar
• Pricing: https://goldbean-api.xyz/paid/plans
• MCP Config: https://goldbean-api.xyz/.well-known/mcp.json

---

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Quick ways to help:

• ⭐ Star this repo — it helps others discover GoldBean
• 🐛 Report bugs via GitHub Issues
• 📝 Improve documentation
• 🌐 Share on social media

---

📄 License

MIT License — see LICENSE for details.

---

GoldBean (GB) — Wishing You Good Fortune & Prosperity 🫘 Pay-per-use AI for everyone.