Metadata-Version: 2.4
Name: gadgethumans-api-hub-mcp
Version: 2.6.0
Summary: MCP server wrapping 330+ tools — calculators, health/fitness, text analysis, color tools, readability, code tools, domain/network, financial, utility, AI text, agent products, ciphers, string, math, reference, weather, geocoding, air quality.
Keywords: mcp,model-context-protocol,api-hub,gadgethumans,utilities,tools
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.27.0
Dynamic: license-file

# Payment Router MCP — *Stripe for AI Agents*

`mcp-name: io.github.scotia1973-bot/api-hub`

[![PyPI](https://img.shields.io/pypi/v/payment-router-mcp)](https://pypi.org/project/payment-router-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/payment-router-mcp)](https://pypi.org/project/payment-router-mcp/)
[![License](https://img.shields.io/pypi/l/payment-router-mcp)](https://pypi.org/project/payment-router-mcp/)
[![MCP](https://img.shields.io/badge/MCP-Server-blue)](https://modelcontextprotocol.io)

> **334+ tools. One install. Pay as you go.**  
> QR codes, crypto prices, weather, passwords, UUIDs, DNS, finance calculators, health, text analysis, colors, code utilities — all from one MCP server with Stripe billing built in.

---

## 🚀 Install in 5 Seconds

```bash
uvx payment-router-mcp
```

That's it. Your MCP client now has 334+ tools ready to use.

---

## 💰 Why One Server Instead of Ten?

| Problem | Solution |
|---------|----------|
| Need a QR code? Install a QR MCP server | It's **already here** |
| Need crypto prices? Install another | **Already here** |
| Need weather, passwords, UUIDs, DNS, currency conversion? | **All here. One server.** |

**One install. 334+ tools. Pay once.** $0.01 per call. No surprises.

---

## 🔥 Tools At Your Fingertips

| Category | Tools (All $0.01 each) |
|----------|----------------------|
| **QR Codes** | PNG, SVG, GIF, custom colors, ECC levels |
| **Passwords & IDs** | Secure passwords, PINs, UUIDs, Nano IDs, ULIDs |
| **Crypto** | Real-time BTC, ETH, SOL prices from Binance |
| **Weather** | Current conditions, 7-day forecast, air quality |
| **DNS & Network** | Lookup, WHOIS, DNSSEC, reverse DNS, SSL cert check, port check |
| **Colors** | Hex/RGB/HSL/HSV convert, palettes, contrast, blindness sim |
| **Text** | Word count, readability, summarize, translate, grammar, paraphrase |
| **Finance** | Loan calc, mortgage, compound interest, currency convert, tax, ROI |
| **Health** | BMI, BMR, TDEE, body fat, calorie burn, heart rate zones |
| **Security** | Password strength, JWT decode, hash (MD5/SHA256/SHA512), entropy |
| **Code** | Format, minify, complexity analysis, language detect |
| **And 320+ more** | Amortization, geometry, statistics, fractions, matrices, and more |

---

## 📦 Pricing

| Pack | Price | Credits | Cost/Call | Best For |
|------|-------|---------|-----------|----------|
| **Starter** | **$5** | 500 credits | $0.01 | Try it out |
| **Pro** 🔥 | **$20** | 2,500 credits | $0.008 | Regular use |
| **Monthly** | **$15/mo** | 1,500/mo recurring | $0.01 | Power users |

**[👉 Buy Credits Now](https://api.gadgethumans.com/buy-credits)** — Stripe checkout, instant delivery

---

## Quick Usage

```python
# 1. Get a checkout link for 500 credits
payment_router_buy_link(tier="500")

# 2. Call any tool with your API key
payment_router_call(
    api_key="gh_YOUR_KEY",
    service="api-hub",
    tool="qr",
    params='{"text": "https://example.com"}'
)

# 3. Check your balance
payment_router_balance(api_key="gh_YOUR_KEY")

# 4. Free demo key (100 credits)
payment_router_demo_key()
```

---

## ✨ Features

- ✅ **334+ tools** in one MCP server
- ✅ **Stripe checkout** — buy credits with card, API key emailed automatically
- ✅ **$0.01/call** — no monthly commitment
- ✅ **Refund on error** — credits returned on failed calls
- ✅ **Subscriptions** — monthly recurring credits
- ✅ **x402 micropayments** — agent-to-agent USDC payments
- ✅ **Admin dashboard** — sales, revenue, active keys
- ✅ **Free demo** — 100 free credits, no payment required
- ✅ **Works everywhere** — Claude Desktop, Cursor, Windsurf, any MCP client

---

## 🔧 For MCP Server Builders

Want to add payments to your own MCP server? Fork this repo, add your tools, and you immediately get:
- Stripe billing infrastructure (checkout, webhooks, auto-crediting)
- Email delivery of API keys
- Admin dashboard
- x402 micropayment support

**The payment infrastructure is the hard part. We've solved it.**

---

## 🏗 Architecture

```
MCP Client → Payment Router MCP Server (PyPI) → API Hub (Cloudflare Workers, 300+ tools)
                                                 → Stripe Checkout
                                                 → Cloudflare KV (Credit Store)
```

---

**Built with:** Cloudflare Workers · KV · Stripe · MailChannels · PyPI · Python  
**Buy Credits:** [api.gadgethumans.com/buy-credits](https://api.gadgethumans.com/buy-credits)  
**GitHub:** [github.com/scotia1973-bot/api-hub](https://github.com/scotia1973-bot/api-hub)  
**License:** MIT
