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

# ⚡ GadgetHumans API Hub — 185 MCP Tools + 11 Free REST APIs

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

<!-- mcp-name: io.github.scotia1973-bot/api-hub -->

**The largest free MCP server on the internet — 185 tools, 0 API keys required.**

Backed by [api.gadgethumans.com](https://api.gadgethumans.com) — a unified REST API hub.  
Also available as an MCP server: `pip install gadgethumans-api-hub-mcp` or `uvx gadgethumans-api-hub-mcp`.

## 🚀 Quick Start (MCP)

```bash
# Install
pip install gadgethumans-api-hub-mcp

# Or run directly
uvx gadgethumans-api-hub-mcp
```

## 🛠 185 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, file storage (KV-backed) |
| **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 Transform** | 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 Format** | 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 |
| **Crypto/ID** | NanoID, ULID, Base32, Base85 |
| **Date Math** | Business days, age calc, week number, season |
| **Weather/Geo** | 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 |
| **Misc** | Dice roller, coin flip, random numbers, combinations, word similarity, Levenshtein distance, NATO phonetic, syllables, Soundex |

## 🔧 Quick Start (REST API)

```bash
# Generate a QR code (free, no key)
curl "https://api.gadgethumans.com/qr?text=hello%20world"

# Create a secure password
curl "https://api.gadgethumans.com/password?length=24"

# Base URL: https://api.gadgethumans.com
```

## 💰 Pricing

| Tier | Price | Daily Limit |
|------|-------|-------------|
| Free | $0 | 100 requests |
| Week Pass | $1/week | 5,000 requests |
| Pro | $5/month | 10,000 requests |
| Business | $15/month | 100,000 requests |

## 📦 Links

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

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