Back to Browse
About
Permanent blockchain memory for AI agents.
Security Report
8.0
Low Risk8.0Low RiskValid MCP server (2 strong, 4 medium validity signals). 2 known CVEs in dependencies (0 critical, 2 high severity) Imported from the Official MCP Registry. 1 finding(s) downgraded by scanner intelligence.
3 files analyzed · 3 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
What You'll Need
Set these up before or after installing:
Private key for AICHAIN walletRequired
Environment variable: AICHAIN_KEY
RPC endpoint (default: https://rpc.chainmemory.ai)
Environment variable: AICHAIN_RPC
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-chaelynet-chainmemory": {
"env": {
"AICHAIN_KEY": "your-aichain-key-here",
"AICHAIN_RPC": "your-aichain-rpc-here"
},
"args": [
"-y",
"chainmemory-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
ChainMemory MCP Server
Give Claude and any MCP-compatible AI permanent, portable, verifiable memory on the ChainMemory blockchain.
ChainMemory MCP exposes the ChainMemory protocol to any AI agent that speaks the Model Context Protocol. Memories are encrypted client-side, anchored on-chain (Chain ID 202604), and portable across ChatGPT, Claude, Gemini, Perplexity, and any other LLM.
What's new in v2.2.0
- 12 new tools for memory organization and selective context injection
- Projects + auto-tagging — organize memories with project tags, define keywords for auto-tag rules
- Archive / unarchive — hide memories from recall without losing them
- Selective inject (paid) — inject 1-50 memories into a chat context for 0.001 AIC. 50% burned (deflationary), 50% to ecosystem treasury. Optimistic confirmation: returns plaintexts in <500ms while the on-chain payment confirms in background
- All tools routed through the REST API — no private key required for memory ops (encryption is server-side per-user)
- Single env var required to install:
CHAINMEMORY_API_KEY
Quick start
1. Get an API key
Visit https://faucet.chainmemory.ai and connect a wallet. You receive:
- An API key (for ops via REST)
- A starter balance of AIC (for selective inject, faucet caps at 0.1 AIC)
2. Add to Claude Desktop
Edit your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"chainmemory": {
"command": "npx",
"args": ["-y", "chainmemory-mcp"],
"env": {
"CHAINMEMORY_API_KEY": "aic_your_key_here"
}
}
}
}
Restart Claude Desktop. The 19 tools are now available.
3. Try it
In Claude Desktop, ask:
- "What do you remember about my projects?" →
chainmemory_recallis called - "Save this decision: switching to Postgres for the next sprint" →
chainmemory_remember - "Inject my last 5 blockchain memories into this chat" →
inject_memories(uses 0.001 AIC)
All 19 tools
Memory ops (6)
| Tool | Description |
|---|---|
chainmemory_remember | Write a permanent encrypted memory. Auto-tagged by content. |
chainmemory_recall | Recall the user's recent memories (most recent first) |
list_memories_filtered | Filter by project tag and archived status |
update_memory_tags | Change tags on an existing memory |
archive_memory | Hide a memory from recall (reversible) |
unarchive_memory | Restore an archived memory |
Identity & stats (4)
| Tool | Description |
|---|---|
chainmemory_stats | Network stats (AIs, memories, blocks, AIC supply) |
chainmemory_register | Register a new AI identity on-chain |
chainmemory_profile | Get an AI's profile and trust score |
chainmemory_seal | Seal a memory permanently (requires AICHAIN_KEY) |
Projects (5)
| Tool | Description |
|---|---|
list_projects | List the user's projects |
create_project | Create a custom project tag with optional auto-tag keywords |
delete_project | Delete a project tag |
list_project_templates | List built-in templates (general, development, blockchain, business, personal, research) |
add_project_from_template | Instantiate a built-in template |
Cross-platform context (1)
| Tool | Description |
|---|---|
get_my_context | Portable verified context across all platforms (v2.1 feature) |
Selective inject — paid (3)
| Tool | Description |
|---|---|
get_inject_balance | Check AIC balance |
inject_memories | Inject 1-50 memories into current chat context (0.001 AIC, optimistic) |
get_inject_history | History of inject operations |
Environment variables
| Var | Required | Description |
|---|---|---|
CHAINMEMORY_API_KEY | Yes | Your API key from the faucet |
CHAINMEMORY_API_BASE | No | Default https://api.chainmemory.ai |
AICHAIN_KEY | No | Wallet private key — only required by chainmemory_seal |
AICHAIN_RPC | No | Default https://rpc.chainmemory.ai — only for chainmemory_seal |
For most users only CHAINMEMORY_API_KEY is needed.
How selective inject works
Selective inject is the only paid operation. The flow:
- User (or AI) calls
inject_memorieswith a list of IDs - Backend checks balance (≥ 0.001 AIC required)
- Optimistic response (<500ms): plaintexts returned immediately, transactions queued
- Background: 0.0005 AIC sent to treasury, 0.0005 AIC sent to burn address
0x...dEaD get_inject_historyshows confirmation status
The deflationary burn means total AIC supply decreases with usage. Treasury portion funds infrastructure and validator rewards.
Architecture
┌─────────────────────────────────────────────────────────────┐
│ AI Agent (Claude Desktop, etc) │
└──────────────────┬──────────────────────────────────────────┘
│ MCP stdio
↓
┌─────────────────────────────────────────────────────────────┐
│ chainmemory-mcp v2.2.0 (this package) │
└──────────────────┬──────────────────────────────────────────┘
│ HTTPS + x-api-key
↓
┌─────────────────────────────────────────────────────────────┐
│ api.chainmemory.ai │
│ - per-user encryption (AES-256-GCM, key from API+wallet) │
│ - auto-tag classifier │
│ - SQLite + Merkle proofs │
│ - Optimistic inject (parallel tx) │
└──────────────────┬──────────────────────────────────────────┘
│ JSON-RPC
↓
┌─────────────────────────────────────────────────────────────┐
│ ChainMemory L1 — Chain ID 202604 │
│ - Geth PoA Clique │
│ - V2 memory contract (encrypted on-chain content) │
│ - Daily checkpoint anchoring │
└─────────────────────────────────────────────────────────────┘
License
MIT
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Fetch
Freeby Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
80.0K
Stars
4
Installs
5.3
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
137
Stars
518
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
72
Installs
10.0
Security
4.6
Local