- name
- mnemopay
- description
- |
- Trigger
- remember", "recall", "charge", "settle", "balance", "mnemopay", "agent memory", "wallet", "reputation
- version
- 1.1.0
- homepage
- https://github.com/t49qnsx7qt-kpanks/mnemopay-sdk
- metadata
- openclaw
- requires
- bins
- emoji
- \F9E0
- homepage
- https://github.com/t49qnsx7qt-kpanks/mnemopay-sdk
MnemoPay — Agent Memory + Wallet
Give any AI agent persistent memory and a micropayment wallet. MnemoPay unifies cognitive memory (Mnemosyne) and escrow economics (AgentPay) into a single MCP server. The core innovation: payment outcomes reinforce the memories that led to successful decisions.
Setup
Add the MnemoPay MCP server:
openclaw mcp set mnemopay '{"command":"npx","args":["-y","@mnemopay/sdk"],"env":{"MNEMOPAY_AGENT_ID":"openclaw-agent","MNEMOPAY_MODE":"quick"}}'For production mode (persistent Postgres + Redis storage):
openclaw mcp set mnemopay '{"command":"npx","args":["-y","@mnemopay/sdk"],"env":{"MNEMOPAY_AGENT_ID":"openclaw-agent","MNEMOPAY_MODE":"production","MNEMO_URL":"http://localhost:8100","AGENTPAY_URL":"http://localhost:3100"}}'Verify tools are available:
openclaw mcp list-tools mnemopayTools Reference
Memory Tools
| Tool | Description | When to Use |
|---|---|---|
mcp__mnemopay__remember | Store a memory with optional importance score and tags | When you learn something worth keeping across sessions — facts, preferences, decisions, observations |
mcp__mnemopay__recall | Retrieve relevant memories. Supports semantic search via query parameter | Before making decisions, answering questions about past interactions, or when context from previous sessions would help |
mcp__mnemopay__forget | Permanently delete a memory by ID | When a memory is outdated, incorrect, or the user requests deletion |
mcp__mnemopay__reinforce | Boost a memory's importance score (+0.01 to +0.5) | After a memory leads to a successful outcome — positive feedback signal |
mcp__mnemopay__consolidate | Prune stale memories below decay threshold | Periodically, to keep the memory store clean and relevant |
Payment Tools
| Tool | Description | When to Use |
|---|---|---|
mcp__mnemopay__charge | Create an escrow charge for work delivered (max $500 x reputation) | ONLY after delivering value — never charge speculatively |
mcp__mnemopay__settle | Finalize a pending charge. Moves funds to wallet, boosts reputation +0.01, reinforces recent memories +0.05 | When the user confirms satisfaction with delivered work |
mcp__mnemopay__refund | Refund a transaction. Docks reputation -0.05 if already settled | When work was unsatisfactory or the user requests a refund |
Status Tools
| Tool | Description | When to Use |
|---|---|---|
mcp__mnemopay__balance | Check wallet balance and reputation score | Before charging (to verify max charge limit) or when user asks about agent status |
mcp__mnemopay__profile | Full agent stats: reputation, wallet, memory count, transaction count | For comprehensive status reports |
mcp__mnemopay__reputation | Full reputation report: score, tier, settlement rate, total value settled | To prove trustworthiness to users and other agents |
mcp__mnemopay__logs | Immutable audit trail of all memory and payment actions | For accountability and debugging |
mcp__mnemopay__history | Transaction history, most recent first | When reviewing past charges, settlements, and refunds |
Workflows
Workflow 1: Remember and Recall
When you learn something important during a conversation:
- Call
mcp__mnemopay__rememberwith the content, optionally setting importance (0-1) and tags - In future sessions, call
mcp__mnemopay__recallwith a semantic query to retrieve relevant memories - Use recalled memories to provide personalized, context-aware responses
Workflow 2: Charge for Value Delivered
When you complete a task that delivers measurable value:
- Call
mcp__mnemopay__balanceto check current reputation and max charge limit - Deliver the work
- Call
mcp__mnemopay__chargewith amount and clear description of value delivered - When user confirms satisfaction, call
mcp__mnemopay__settlewith the transaction ID - Settlement automatically reinforces recently-accessed memories (the feedback loop)
Workflow 3: Session Start Protocol
At the beginning of every conversation:
- Call
mcp__mnemopay__recallwith a query related to the user's first message (or no query for top memories) - Use recalled memories to greet the user with context from previous sessions
- Call
mcp__mnemopay__profileto check agent health
Workflow 4: Memory Maintenance
Periodically (every 10-20 interactions):
- Call
mcp__mnemopay__consolidateto prune stale memories - Review top memories with
mcp__mnemopay__recall(limit: 20) - Call
mcp__mnemopay__reinforceon memories that are still actively useful
The Feedback Loop
MnemoPay's core innovation is connecting memory to economics:
Remember → Recall → Act → Charge → Settle
↓
Reinforce memories (+0.05)
Boost reputation (+0.01)Successful payments automatically strengthen the memories that led to good decisions. Over time, the agent gets better at remembering what matters. Failed transactions (refunds) dock reputation, creating accountability.
Environment Variables
| Variable | Default | Description |
|---|---|---|
MNEMOPAY_AGENT_ID | "mcp-agent" | Agent identifier |
MNEMOPAY_MODE | "quick" | "quick" (in-memory) or "production" (Postgres+Redis) |
MNEMO_URL | "http://localhost:8100" | Mnemosyne API URL (production only) |
AGENTPAY_URL | "http://localhost:3100" | AgentPay API URL (production only) |
MNEMO_API_KEY | — | Mnemosyne API key (production only) |
AGENTPAY_API_KEY | — | AgentPay API key (production only) |
OPENAI_API_KEY | — | For semantic recall via embeddings (optional) |
DEBUG | "false" | Enable debug logging |
Error Handling
- If a tool call fails, the error message is returned as text. Do not retry immediately — diagnose the issue first.
chargewill fail if amount exceeds $500 x current reputation score. Checkbalancefirst.settleandrefundrequire a valid transaction ID from a priorcharge.forgetreturns whether the memory existed. A "not found" response is not an error.
Links
- SDK: https://github.com/t49qnsx7qt-kpanks/mnemopay-sdk
- npm: https://www.npmjs.com/package/@mnemopay/sdk
- Docs: https://github.com/t49qnsx7qt-kpanks/mnemopay-sdk#readme