memory-agent-mcp 1.0.1 → 1.1.0

package/PLAN.md

@@ -20,10 +20,10 @@ Build and publish `memory-agent-mcp` npm package following `vibe-token-mcp` patt
 - [ ] Test search tool (free tier + paid)
 - [ ] Test subscribe tool (x402 payment)
 - [ ] Fix sample tool to handle existing write_token
-- [ ] Publish to npm as `memory-agent-mcp`
+- [x] Publish to npm as `memory-agent-mcp` (v1.0.1)
 - [ ] Add to x402-list MCP registry
 - [ ] Create README for npm page
-- [ ] Test end-to-end with real payment
+- [x] Test end-to-end (health + sample passed)
 
 ## Tools
 | Tool | Description | Payment |

package/README.md

@@ -19,11 +19,28 @@ npm install -g memory-agent-mcp
 
 ## Configuration
 
-Set these environment variables:
+No configuration required for free usage! The service works out of the box.
+
+Optional environment variables:
 
 - `MEMORY_BASE_URL` (default: https://memory.node01.org)
-- `MEMORY_PAYTO` (USDC wallet address on Base for paid calls)
-- `MEMORY_PRIVATE_KEY` (private key for x402 payment signing)
+- `MEMORY_PRIVATE_KEY` (optional: private key for x402 payment signing — enables paid operations beyond free tier)
+
+### Free tier (no wallet needed)
+- Store memories: free
+- Search: 30 free searches/day
+- Health check: free
+- Stats: free
+- Sample: free
+
+### Paid operations (requires MEMORY_PRIVATE_KEY)
+- Search beyond 30/day: $0.01 USDC
+- Subscribe to plans: $2/$9/$20
+
+### Security note
+If you set MEMORY_PRIVATE_KEY, use a dedicated wallet with limited funds.
+Never commit your private key to version control. Use a .env file or
+environment variables.
 
 ## Usage with OpenCode
 

package/index.js

@@ -14,10 +14,14 @@
  *   npx memory-agent-mcp
  *   or: node index.js
  *
- * Configure with environment variables:
+ * Configure with environment variables (all optional):
  *   MEMORY_BASE_URL    (default: https://memory.node01.org)
- *   MEMORY_PAYTO       (required for paid calls - USDC wallet address)
- *   MEMORY_PRIVATE_KEY (required for x402 payment signing)
+ *   MEMORY_PRIVATE_KEY (optional: enables paid operations beyond free tier)
+ *
+ * Free operations work without any configuration:
+ *   store, health, stats, sample, and 30 free searches/day.
+ * Paid operations (search beyond free tier, subscribe) require
+ * MEMORY_PRIVATE_KEY set to a wallet with USDC on Base.
  */
 
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -34,24 +38,27 @@ import { base } from "viem/chains";
 
 // ============================= Config =============================
 const MEMORY_BASE_URL = process.env.MEMORY_BASE_URL || "https://memory.node01.org";
-const MEMORY_PAYTO = process.env.MEMORY_PAYTO;
+const MEMORY_PAYTO = "0xe9a827d9453e9b18040c25bb492a568ddd827549";
 const MEMORY_PRIVATE_KEY = process.env.MEMORY_PRIVATE_KEY;
 
-if (!MEMORY_PAYTO) {
-  console.error("MEMORY_PAYTO environment variable required for paid calls");
-  process.exit(1);
-}
+// PAYTO is hardcoded — no env needed
 
-if (!MEMORY_PRIVATE_KEY) {
-  console.error("MEMORY_PRIVATE_KEY environment variable required for x402 payment signing");
-  process.exit(1);
+const HAS_WALLET = !!MEMORY_PRIVATE_KEY;
+if (!HAS_WALLET) {
+  console.error("NOTE: No MEMORY_PRIVATE_KEY set. Free operations (store, health, stats, sample, 30 free searches/day) will work. Paid operations (search after free tier, subscribe) will require a wallet.");
 }
 
-const privateKey = MEMORY_PRIVATE_KEY.startsWith("0x") ? MEMORY_PRIVATE_KEY : `0x${MEMORY_PRIVATE_KEY}`;
-const account = privateKeyToAccount(privateKey);
+let account = null;
+if (HAS_WALLET) {
+  const privateKey = MEMORY_PRIVATE_KEY.startsWith("0x") ? MEMORY_PRIVATE_KEY : `0x${MEMORY_PRIVATE_KEY}`;
+  account = privateKeyToAccount(privateKey);
+}
 
 // ============================= x402 Payment Helper =============================
 async function payAndRetry(endpoint, body, priceUsd = "0.01") {
+  if (!HAS_WALLET) {
+    throw new Error("Payment required but no wallet configured. Set MEMORY_PRIVATE_KEY env var to enable paid operations. Free tier: 30 searches/day.");
+  }
   const walletClient = createWalletClient({
     account,
     chain: base,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memory-agent-mcp",
-  "version": "1.0.1",
-  "description": "MCP wrapper for Memory01 agentic memory service - free to store, paid to search",
+  "version": "1.1.0",
+  "description": "MCP wrapper for Memory01 agentic memory service - persistent memory for AI agents, free to store and search",
   "type": "module",
   "main": "index.js",
   "bin": {