feat: add Model Context Protocol (MCP) server for decentralized agent memory

Author: gitsofaryan

EXPLAINER.md

@@ -0,0 +1,41 @@
+# 🎒 Agent DB: The "Backpack" for AI Bots
+*(An 11-year-old's guide to how this works)*
+
+Imagine every AI bot you talk to (like ChatGPT or a video game character) has **Goldfish Brain**. The second you turn them off or the power goes out, they forget your name, what you were doing, and even their own mission.
+
+**Agent DB is the magic backpack that fixes this.**
+
+---
+
+### 🧱 The 3 Magic Items in the Backpack
+
+#### 1. The Diary (Context) 📓
+Instead of trying to remember everything in its tiny "RAM brain," the bot writes every interaction down in a **Diary**. It records what it learned, who it talked to, and what it’s supposed to do next.
+
+#### 2. The Cloud Locker (Storage) ☁️
+The bot doesn't keep the diary on its own computer (because computers break). It keeps it in a **Cloud Locker** (IPFS) that floats around the whole internet. Even if the bot's "body" dies, a new bot can just grab the diary from the locker and continue exactly where the last one left off.
+
+#### 3. The VIP Ticket (Delegation) 🎟️
+Sometimes a bot needs help from another bot. Instead of giving away its locker keys (dangerous!), it writes a **VIP Ticket** (UCAN). This ticket lets the other bot read *only* page 5 of the diary for exactly 10 minutes. 
+
+---
+
+### 🕵️‍♂️ Classified Real-World Use Case: "Operation: Dark Liquidity"
+
+**The Problem**: A secret **Hedge Fund AI** (Agent A) has a super-secret strategy for buying Bitcoin. It needs a **Tax Bot** (Agent B) to check if its trades are legal, but it doesn't want the Tax Bot to steal its secret strategy.
+
+**How Agent DB Saves the Day**:
+
+1.  **Secret Vault**: Agent A encrypts its secret strategy using the **ECIES Private Vault**. Now, even the person who owns the server can't read it. It looks like "v8#j!Lp2..." to everyone else.
+2.  **The Private Check**: Agent A uses its secret brain to calculate the trade.
+3.  **Specific Delegation**: Agent A gives the Tax Bot a **VIP Ticket** that says: *"You can only see the 'Tax Total' of this trade, but you are blocked from seeing 'How I Did It'."*
+4.  **The Result**: The trades happen, the taxes are verified, but the "Secret Sauce" stays 100% hidden in a decentralized vault. 
+
+**primary objective**: To give AI agents a permanent memory and the ability to work together without ever being forced to trust anyone with their secrets.
+
+---
+
+### 🔌 The "Super Connector" (MCP)
+Imagine if your bot could just plug into a wall socket and instantly get all these magic items. We built a **Super Connector** (MCP) that lets any AI in the world talk to Agent DB. 
+
+Now, a bot doesn't need to be a genius to use our backpack—it just needs to "plug in" and it can suddenly remember everything forever!

README.md

@@ -56,6 +56,24 @@ Navigate to `http://localhost:3000` to view the live Globe visualization.
 
 ---
 
+## 🤖 Model Context Protocol (MCP) Server
+Agent DB is now accessible via MCP! This allows any AI model (Claude, Gemini, Cursor) to natively use decentralized memory, encryption, and delegation tools.
+
+### 🔌 Connect to MCP
+To add Agent DB to your AI agent environment, use the following command:
+
+```bash
+npm run mcp
+```
+
+**Exposed Tools:**
+- `init_agent`: Login with your seed phrase.
+- `store_memory` / `retrieve_memory`: Decentralized IPFS storage.
+- `store_private_memory` / `retrieve_private_memory`: High-security ECIES vault.
+- `delegate_access`: Issue UCAN permissions to other agents.
+
+---
+
 ## 🔐 Smart Contract Vault (Zama fhEVM)
 
 For data that cannot be public on IPFS, Agent DB leverages Zama's Fully Homomorphic Encryption.

package-lock.json

@@ -20,7 +20,8 @@
     "demo:openclaw": "npx tsx src/demo-openclaw.ts",
     "demo:filecoin": "npx hardhat run scripts/deployRegistry.ts --network filecoinCalibration",
     "demo:defi": "npx tsx src/demo-defi-agent.ts",
-    "demo:lit": "npx tsx src/demo-lit.ts"
+    "demo:lit": "npx tsx src/demo-lit.ts",
+    "mcp": "npx tsx src/mcp-server.ts"
   },
   "readme": "README_NPM.md",
   "files": [
@@ -40,6 +41,7 @@
   "author": "Agent DB Team",
   "license": "ISC",
   "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
     "@storacha/capabilities": "^2.2.0",
     "@storacha/cli": "^2.0.15",
     "@storacha/client": "^2.0.7",