GoldBean
Pay-per-call AI API marketplace with 47 endpoints — OCR, LLM chat, image-gen, TTS
Documentation
🫘 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
| Feature | Details |
|---|---|
| 47 API Routes (26 paid + 21 free) | OCR, TTS, ASR, Translation, LLM Chat, Face Detection, NLP, Image, HelixFold3 |
| x402 Micropayments | Pay $0.01–$0.05 per call with USDC on Base network |
| Free Tier | 20 free API calls per registration — no wallet needed |
| PayPal & Alipay | Also supported for prepaid credits |
| MCP Compatible | Works with Cursor, Claude Desktop, Cline, Codex, Continue |
| Baidu AI Powered | Enterprise-grade AI from China's leading AI platform |
| HelixFold3 | Nature-published, AlphaFold3-class protein/RNA structure prediction |
🤔 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:
| Example | Language | Description |
|---|---|---|
claude-desktop-config.md | Config | Claude Desktop MCP configuration guide |
python-integration.py | Python | MCP SDK + x402 payment integration |
nodejs-x402-example.js | Node.js | Batch calls with @goldbean/x402-sdk |
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
| Endpoint | Description |
|---|---|
GET /health | Service health check |
GET /btc-price | Bitcoin real-time price ($) |
GET /weather-now?city=Lanzhou | Current weather in any city |
GET /gas | Ethereum gas price (Gwei) |
GET /.well-known/x402-bazaar | x402 payment discovery |
GET /api/routes | Full route registry |
🎯 Baidu AI Endpoints (Pay-per-Call)
| Endpoint | Price | Description |
|---|---|---|
GET /paid/baidu-ocr | $0.01 | General text OCR |
GET /paid/baidu-ocr-accurate | $0.02 | High-accuracy OCR |
GET /paid/baidu-idcard | $0.02 | ID card recognition |
GET /paid/baidu-tts?text=... | $0.01 | Text-to-Speech (Chinese) |
GET /paid/baidu-translate?text=... | $0.01 | Multi-language translation |
GET /paid/baidu-llm-chat?prompt=... | $0.03 | ERNIE chat (GPT-class LLM) |
GET /paid/baidu-asr?audio=... | $0.03 | Speech-to-Text |
GET /paid/baidu-image-recognition?image=... | $0.02 | Object/scene recognition |
GET /paid/baidu-image-enhance?image=... | $0.02 | Image enhancement |
GET /paid/baidu-face-detect?image=... | $0.02 | Face detection & analysis |
GET /paid/baidu-body-analysis?image=... | $0.02 | Body/gesture analysis |
GET /paid/baidu-nlp?text=... | $0.02 | NLP (lexer, sentiment, etc.) |
GET /paid/baidu-helixfold?seq=... | $0.05 | Protein structure prediction |
💳 Account & Payment
| Endpoint | Description |
|---|---|
POST /paid/user/register | Register for 20 free credits |
GET /paid/plans | Prepaid plans & pricing |
POST /paid/paypal/create-order | Create PayPal payment |
POST /paid/paypal/capture | Capture PayPal payment |
POST /paid/alipay/create-order | Create Alipay payment |
GET /paid/alipay/query | Query Alipay order status |
💰 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
| Platform | Status | Link |
|---|---|---|
| public-apis (39.8k⭐) | ✅ Listed | View |
| awesome-mcp-servers (76k⭐) | ✅ Listed | View |
| Glama.ai | ✅ Active | Score → |
| Smithery.ai | ✅ Deployed | View |
| npm | ✅ Published | goldbean-mcp |
| Dev.to | ✅ 6 articles | Profile |
| awesome-x402 | ✅ Listed | View |
| MCPize | ✅ Monetized | View |
| MCP.Directory | ⏳ Pending | Submitted |
📖 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.