GadgetHumans API Hub

🚀 GadgetHumans MCP API Hub — Starter Template

170+ free MCP tools — pre-configured and ready to use. Click "Use this template" above to create your own repository with zero configuration.

---

✨ What's Included

This template gives you a fully configured Model Context Protocol (MCP) server that connects to the GadgetHumans API Hub — a collection of 170+ free developer tools including:

Category	Tools
🆔 UUID Generation	v4 UUIDs, batch generation
🔐 Password Generator	Customizable length, symbols, numbers, uppercase/lowercase
🎨 Color Converter	HEX ↔ RGB conversion
🔄 Base64 Encoder/Decoder	Encode and decode Base64
🔑 Hash Generator	MD5, SHA-1, SHA-256, SHA-512
✅ Email Verification	Syntax check, MX records, disposable detection
📱 QR Code Generator	PNG, SVG, GIF output
📝 Lorem Ipsum	Paragraphs, sentences, words
🎯 JSON Formatter	Prettify, validate, minify
📍 IP Geolocation	Location, ISP, timezone
🏥 Health Check	Endpoint availability monitoring

All tools are free, open source, and require no API keys.

---

🚦 Quick Start

Option 1: Claude Desktop (Recommended)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "gadgethumans-api-hub": {
      "command": "uvx",
      "args": ["gadgethumans-api-hub-mcp"]
    }
  }
}

Option 2: Cursor IDE

Add this to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "gadgethumans-api-hub": {
      "command": "uvx",
      "args": ["gadgethumans-api-hub-mcp"]
    }
  }
}

Option 3: Smithery.ai (Cloud Hosted)

Deploy to Smithery with zero infrastructure — see smithery.yaml.

---

📦 Manual Installation

# Install via uvx (no install required)
uvx gadgethumans-api-hub-mcp

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

# Run the server
python -m gadgethumans_api_hub_mcp

---

🏗️ Project Structure

gadgethumans-mcp-starter/
├── README.md                  # This file
├── smithery.yaml              # Smithery deployment config
├── claude_desktop_config.json # Claude Desktop config example
├── .cursor/
│   └── mcp.json              # Cursor IDE config example
└── LICENSE                    # MIT License

---

🧪 Testing the Connection

Once your MCP client is configured, you should see these tools available:

- generate_uuid          → Generate UUID v4 identifiers
- generate_password      → Generate secure random passwords
- convert_color          → Convert HEX ↔ RGB
- encode_base64          → Base64 encode/decode
- hash_text              → Cryptographic hashing
- verify_email           → Email validation
- generate_qr_code       → QR code generation
- generate_lorem_ipsum   → Placeholder text
- process_json           → JSON formatting
- geolocate_ip           → IP geolocation
- health                 → Endpoint health check

---

📄 License

MIT — free for any use, commercial or personal.

---

🙌 Contributing

Found a bug? Want a new tool? Open an issue or contribute via pull request.

---

Made with ❤️ by GadgetHumans