Metadata-Version: 2.4
Name: gadgethumans-api-hub-mcp
Version: 2.4.2
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

# ⚡ GadgetHumans API Hub — 337 MCP Tools + Credit System

> `mcp-name: com.gadgethumans.api/api-hub`
>
> [![PyPI version](https://badge.fury.io/py/gadgethumans-api-hub-mcp.svg)](https://pypi.org/project/gadgethumans-api-hub-mcp/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![API Status](https://img.shields.io/badge/status-100%25%20operational-success)](https://api.gadgethumans.com)

**337 developer tools in one MCP server — free tier + prepaid credits for power users.**

Backed by [api.gadgethumans.com](https://api.gadgethumans.com) — a unified REST API hub.  
Install: `pip install gadgethumans-api-hub-mcp` or `uvx gadgethumans-api-hub-mcp`.

## 🚀 Quick Start

```bash
# Run directly — no config needed
uvx gadgethumans-api-hub-mcp

# Or install
pip install gadgethumans-api-hub-mcp
```

That's it. 337 tools at your fingertips in any MCP-compatible client (Claude Desktop, Cursor, Copilot, etc.).

## 🛠 337 Tools — Every Category

| Category | Tools |
|----------|-------|
| **Utility** | QR codes, passwords, UUIDs, hashing, base64, lorem ipsum, JSON processing, color conversion, email verification, IP geolocation, timestamps |
| **AI Text** | Chat, memory, rewrite, summarize, translate, grammar, tldr, paraphrase, headline, keywords, sentiment, classify, explain, faq, bullets, questions, social, quiz |
| **Agent Products** | Web search, URL reader, website crawl, web scraper, file storage |
| **Web/SEO** | OG metadata, DNS lookup, SSL check, whois, page-size, link-check, meta-scrape, RSS parser, URL analyzer |
| **Finance** | Crypto prices, currency exchange, VAT validate, IBAN validate, mortgage calc, loan calc, investment calc |
| **Math/Stats** | Fibonacci, prime checker, factorial, GCD/LCM, percentage, BMI, tip, discount, geometry, stats, matrix, correlation |
| **Text** | Slugify, case convert, truncate, reverse, shuffle, padding, wrap, indent, remove accents, binary convert |
| **Ciphers** | Atbash, morse code, vigenère, caesar, ROT13, alternating-case, invert-case |
| **Data** | CSV↔JSON, JSON↔XML, JSON↔YAML, TOML↔JSON, INI↔JSON, TSV↔JSON |
| **Reference** | Country list, currency list, language list, color names, HTML entities, HTTP codes, MIME types, emoji list, ASCII table, paper sizes, chemical elements |
| **Readability** | Flesch-Kincaid, Gunning Fog, SMOG, ARI, Dale-Chall, FORCAST, Linsear Write, clarity score, text complexity |
| **Health** | BMI, BMR, TDEE, body fat, heart rate zones, calorie burn, macro calculator, water intake, VO2 max |
| **Code** | Complexity analysis, stats, beautify, indentation check, comment strip, bracket matching, language detection, TODO finder |
| **Network** | Domain age, DNSSEC, DNS records, CDN detection, reverse DNS, email domain check, port check |
| **IDs** | NanoID, ULID, Base32, Base85 |
| **Dates** | Business days, age calc, week number, season |
| **Weather** | Current weather, 7-day forecast, geocode, reverse geocode, air quality, distance calc |
| **Conversions** | Speed, area, volume, pressure, temperature, time, angle, energy, data rate, pixel, bytes format |
| **DeepSeek V4 Flash** | OpenAI-compatible chat — free tier (rate limited) or 1 credit/call |
| **Web Scraper** | Fetch any URL → clean markdown — requires API key |

## 🔧 Quick REST API (no install needed)

```bash
# Free — no API key required
curl "https://api.gadgethumans.com/qr?text=hello%20world"
curl "https://api.gadgethumans.com/password?length=24"
curl "https://api.gadgethumans.com/weather?city=London"

# Paid — requires API key
curl -X POST "https://api.gadgethumans.com/chat" \
  -H "x-api-key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Hello!"}]}'
```

## 💰 Pricing — Prepaid Credits

| Pack | Price | Credits | What it buys |
|------|-------|---------|-------------|
| Free | $0 | Unlimited* | 325+ utility tools (QR, passwords, UUIDs, weather, etc.) |
| Starter | **$5** | **500 credits** | DeepSeek V4 Flash chat + Web Scraper (1 credit/call) |
| Pro | **$20** | **2,500 credits** | Everything + better per-call rate |
| Monthly | **$15/mo** | **1,500 credits/mo** | Auto-top-up, never run out |

\*Free tier: 10 requests/day per IP. No API key needed.  
Paid: 1 credit ≈ $0.01. Credits never expire. Buy at [api.gadgethumans.com/buy-credits](https://api.gadgethumans.com/buy-credits).

## 🔗 Links

- **MCP Server (PyPI):** https://pypi.org/project/gadgethumans-api-hub-mcp/
- **API Gateway:** https://api.gadgethumans.com
- **GitHub:** https://github.com/scotia1973-bot/api-hub
- **Website:** https://www.gadgethumans.com
- **Buy Credits:** https://api.gadgethumans.com/buy-credits

Built with ⚡ by [Gadget Humans](https://www.gadgethumans.com)
