Content
# 🧠 Memory Vault — *Don't Let Your Agent Wake Up Amnesic*
> **Every AI agent forgets everything between sessions. Memory Vault fixes that.**
>
> Persistent cross-session memory for any MCP-compatible agent — Claude Code, Cursor, Windsurf, Codex CLI, Copilot, and 100+ more. Plus 45 utility tools.
[](https://pypi.org/project/gadgethumans-api-hub-mcp/)
[](LICENSE)
[](https://glama.ai/mcp/servers/scotia1973-bot/api-hub)
[](https://api.gadgethumans.com)
[](https://registry.modelcontextprotocol.io)
[](https://smithery.ai/server/scotia1973/api-hub2)
[](https://star-history.com/#scotia1973-bot/api-hub&Date)
---
## ✨ Why Memory Vault?
AI agents have a **fundamental limitation**: they're born with amnesia. Every new session is a blank slate. They forget:
- ✅ What you asked them to do
- ✅ What they learned about your project
- ✅ What config/credentials they set up
- ✅ What they already told another tool
**Memory Vault is the first MCP server that gives agents permanent memory.** Store once, recall forever. No more "I already told you this."
```bash
# Agent says: "I don't remember our previous conversation"
# With Memory Vault: "I remember — here's what we discussed last session"
```
---
## 🚀 Quick Start (5 seconds)
### Option A: Hosted endpoint (no install)
```bash
# Add to your MCP client config:
{
"mcpServers": {
"memory-vault": {
"url": "https://api.gadgethumans.com/mcp"
}
}
}
```
### Option B: Local via uvx
```bash
uvx gadgethumans-api-hub-mcp
```
### Option C: Install
```bash
pip install gadgethumans-api-hub-mcp
```
**That's it. 46 MCP tools. Instant memory.**
---
## 🧠 The Memory Vault (Killer Feature)
| Tool | What it does |
|------|-------------|
| `agent_memory` | Store/recall/delete persistent data by key. Agents remember across sessions forever. |
| `memory_search` | Full-text search across everything you've stored. |
| `memory_list` | Browse all stored keys by category. |
| `agent_profile` | View your vault stats, usage, and upgrade options. |
### How it works
```
Session 1: Agent stores "project_config" → KV saves it forever
↓
Session 2 (days later): Agent recalls "project_config" → instant retrieval
↓
Session 100: Agent still remembers. Never forgets.
```
**Data never expires.** Stored in Cloudflare KV (99.99% durability). Only accessible by your agent.
---
## 🛠 45 Utility Tools — Everything Else
| Category | Tools |
|----------|-------|
| 🔐 **Security** | QR codes, password generator, UUIDs, hash (MD5/SHA256/SHA512), Base64, NanoID, ULID |
| 💰 **Finance** | Crypto prices (Binance), currency exchange, mortgage calc, loan calc, investment calc, tax bracket, VAT calc, salary calc, compound interest |
| 🌤️ **Weather** | Current weather, 7-day forecast, geocode, reverse geocode, air quality |
| 🌐 **Web** | OG metadata, URL analyzer, RSS parser, meta scrape, link checker, page size, HTTP headers |
| 📡 **Network** | DNS lookup, reverse DNS, DNSSEC, SSL check, WHOIS, domain age, CDN detect, port check, IP geolocation |
| 📝 **Text** | Slugify, case convert, truncate, reverse, shuffle, padding, wrap, indent, remove accents, stopword removal, binary/base conversion |
| 🎨 **Colors** | Hex↔RGB↔HSL↔HSV↔CMYK, color palette, contrast check, color harmony, color blindness sim |
| 📊 **Data** | CSV↔JSON, JSON↔XML↔YAML, TOML↔JSON, INI↔JSON, TSV↔JSON, diff, merge, flatten, sort, filter, dedupe |
| 🔢 **Math** | Fibonacci, prime check, factorial, GCD/LCM, percentage, stats, matrix ops, correlation, quadratic solver, geometry |
| 🏥 **Health** | BMI, BMR, TDEE, body fat, calorie burn, macro calc, water intake, heart rate zones, VO₂ max |
| 📖 **Readability** | Flesch-Kincaid, Gunning Fog, SMOG, ARI, Dale-Chall, FORCAST, Linsear Write, clarity score |
| 💻 **Code** | Complexity analysis, stats, beautify, indent check, comment strip, bracket matching, language detection, TODO finder, SQL format |
| 🔄 **Conversions** | Speed, area, volume, pressure, temperature (all units), time, angle, energy, data rate, pixels, bytes |
| 🔓 **Ciphers** | Atbash, Caesar, ROT13, Vigenère, Morse code, NATO phonetic, Base32, Base85 |
| 🌍 **Reference** | Countries, currencies, languages, HTML entities, HTTP codes, MIME types, emoji list, ASCII table, paper sizes, chemical elements, keyboard layouts |
| 📅 **Dates** | Business days, age calculator, week number, season, timezone conversion |
| 🏃 **Fitness** | BMI, BMR, TDEE, body fat, ideal weight, calorie burn, macro calc, water intake, sleep calc, pace calc |
**Plus 300+ REST endpoints** via the `call_api` proxy tool.
---
## 💰 Pricing
| Tier | Price | Requests/day | Memory |
|------|-------|-------------|--------|
| 🆓 **Free** | $0 | 100 | ✅ Persistent |
| ⭐ **Pro** | **$2.99/mo** | 500 | ✅ Unlimited |
| 🏢 **Enterprise** | **$9.99/mo** | Unlimited | ✅ Unlimited |
👉 **[Subscribe to Pro →](https://api.gadgethumans.com/mcp-subscribe)**
---
## 🔧 REST API (no MCP needed)
```bash
# Free — no API key
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"
curl "https://api.gadgethumans.com/crypto?symbol=bitcoin"
curl "https://api.gadgethumans.com/dns?domain=example.com"
```
All 300+ endpoints at **[api.gadgethumans.com](https://api.gadgethumans.com)**
---
## 🏗️ Architecture
```
┌─────────────┐ ┌──────────────────────────┐ ┌──────────────┐
│ AI Agent │────→│ Memory Vault MCP │────→│ Cloudflare │
│ (Claude, │ │ api.gadgethumans.com/mcp│ │ Worker + KV │
│ Cursor, │ │ │ │ │
│ Codex, etc)│ │ ┌────────────────────┐ │ │ ┌────────┐ │
│ │ │ │ agent_memory │ │────→│ │ KV │ │
│ │ │ │ memory_search │ │ │ │ Store │ │
│ │ │ │ memory_list │ │ │ └────────┘ │
│ │ │ │ 45 utility tools │ │ │ │
│ │ │ │ call_api (300+ ) │ │ │ ┌────────┐ │
│ │ │ └────────────────────┘ │ │ │REST API│ │
└─────────────┘ └──────────────────────────┘ │ │ 300+ │ │
│ │ routes │ │
│ └────────┘ │
└──────────────┘
```
---
## 📦 Links
| Resource | Link |
|----------|------|
| **MCP Endpoint** | `https://api.gadgethumans.com/mcp` |
| **PyPI Package** | [`gadgethumans-api-hub-mcp`](https://pypi.org/project/gadgethumans-api-hub-mcp/) |
| **Install** | `pip install gadgethumans-api-hub-mcp` or `uvx gadgethumans-api-hub-mcp` |
| **MCP Registry** | `com.gadgethumans.api/api-hub` |
| **Glama** | [glama.ai/mcp/servers/scotia1973-bot/api-hub](https://glama.ai/mcp/servers/scotia1973-bot/api-hub) |
| **Smithery** | [smithery.ai/server/scotia1973/api-hub2](https://smithery.ai/server/scotia1973/api-hub2) |
| **Subscribe** | [api.gadgethumans.com/mcp-subscribe](https://api.gadgethumans.com/mcp-subscribe) |
| **API Gateway** | [api.gadgethumans.com](https://api.gadgethumans.com) |
| **Website** | [gadgethumans.com](https://www.gadgethumans.com) |
---
## 🤝 Compatibility
Works with any MCP-compatible client:
- **Claude Desktop / Claude Code**
- **Cursor**
- **Windsurf**
- **Codex CLI**
- **GitHub Copilot**
- **Continue.dev**
- **Cline**
- **OpenAI Responses API**
- **Any MCP host**
---
## 📝 License
MIT — do what you want. Built with ⚡ by [Gadget Humans](https://www.gadgethumans.com).
---
*Star this repo if Memory Vault helped your agent remember something important. ⭐*
