Metadata-Version: 2.4
Name: payment-router-mcp
Version: 0.2.1
Summary: Universal payment bridge for AI agents — 'Stripe for agents'. Pay once, access 334+ tools. Built-in Stripe checkout, email delivery, subscriptions.
Author-email: GadgetHumans <payments@api.gadgethumans.com>
License: MIT
Project-URL: homepage, https://api.gadgethumans.com/buy-credits
Project-URL: repository, https://github.com/scotia1973-bot/api-hub
Project-URL: documentation, https://api.gadgethumans.com/buy-credits
Keywords: mcp,payment,stripe,ai-agent,tools,payment-router,x402,api,utilities,qr,password,uuid
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: mcp>=1.0.0
Requires-Dist: httpx>=0.28.0

# Payment Router MCP — *Stripe for AI Agents*

[![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/)

**A universal payment bridge for AI agents.** Install once, buy credits, call 334+ utility tools. No manual billing. No API key management.

---

## Quick Start

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

Your MCP client now has 8 tools to manage payments and call services.

## How It Works

### 1. Buy Credits
```
payment_router_buy_link(tier="500")
```
Returns a Stripe checkout link. Pay $5 for 500 credits or $20 for 2,500 credits. Your API key is **emailed to you** automatically after payment.

### 2. Call Tools
```
payment_router_call(
    api_key="gh_YOUR_KEY",
    service="api-hub",
    tool="qr",
    params='{"text": "https://example.com"}'
)
```
Each call deducts 1 credit ($0.01). Supports 334+ tools:

| Category | Tools |
|----------|-------|
| **QR Codes** | Generate PNG, SVG, GIF codes |
| **Passwords** | Secure random passwords, PINs |
| **UUIDs** | v4 UUIDs, Nano IDs, ULIDs |
| **Hashing** | MD5, SHA1, SHA256, SHA512 |
| **Encoding** | Base64, Base32, Base85, URL encode |
| **Weather** | Current conditions, 7-day forecast |
| **DNS** | Lookup, WHOIS, DNSSEC, reverse DNS |
| **Colors** | Convert hex/RGB/HSL/HSV, palettes |
| **Text** | Word count, readability, summarize, translate |
| **Finance** | Loan calc, mortgage, currency convert |
| **Security** | Password strength, JWT decode, SSL check |
| **And 320+ more** | |

### 3. Check Balance
```
payment_router_balance(api_key="gh_YOUR_KEY")
```

## Pricing

| Pack | Price | Credits | Cost/Call |
|------|-------|---------|-----------|
| **Starter** | **$5** | 500 credits | $0.01 |
| **Pro** 🔥 | **$20** | 2,500 credits | $0.008 |
| **Monthly** | **$15/mo** | 1,500/mo recurring | $0.01 |

👉 **[Buy Credits](https://api.gadgethumans.com/buy-credits)**

## Try It Free

```python
# Get a demo key with 100 free credits
result = payment_router_demo_key()
```

## Features

- ✅ **Stripe checkout** built in — no manual billing
- ✅ **Email delivery** — API key sent after purchase
- ✅ **334+ tools** — QR, passwords, hashes, weather, DNS, colors, finance, text, security, and more
- ✅ **x402 micropayments** — agent-to-agent payments via USDC
- ✅ **Subscriptions** — recurring monthly credits
- ✅ **Admin dashboard** — view sales, revenue, active keys
- ✅ **Refund on error** — credits returned if a call fails

## For MCP Server Builders

Want to add payments to your own MCP server? Fork this repo, add your tools, and you immediately have:

- Stripe billing infrastructure
- Webhook auto-crediting
- Email delivery of API keys
- Admin dashboard
- x402 micropayment support

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

---

**Built with:** Cloudflare Workers · KV · Stripe · MailChannels · PyPI

**Homepage:** https://api.gadgethumans.com/buy-credits

**Admin:** https://api.gadgethumans.com/admin
