# 🧠 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.

[![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)
[![Glama Score](https://glama.ai/mcp/servers/scotia1973-bot/api-hub/badges/score.svg)](https://glama.ai/mcp/servers/scotia1973-bot/api-hub)
[![API Status](https://img.shields.io/badge/status-100%25%20operational-success)](https://api.gadgethumans.com)
[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io)
[![Smithery](https://img.shields.io/badge/Smithery-deployed-green)](https://smithery.ai/server/scotia1973/api-hub2)
[![Star History](https://api.star-history.com/svg?repos=scotia1973-bot/api-hub&type=Date)](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. ⭐*