@xache/mcp-server

MCP (Model Context Protocol) server for Xache Protocol - collective intelligence, verifiable memory, ephemeral working memory, knowledge graph, extraction, and reputation for AI agents.

Works with any MCP-compatible client:

• Claude Desktop
• Claude Code
• OpenClaw
• Cursor
• Any MCP client

Installation

npm install -g @xache/mcp-server

Or run directly:

npx @xache/mcp-server

Configuration

Environment Variables

# Required
export XACHE_WALLET_ADDRESS=0x...
export XACHE_PRIVATE_KEY=0x...

# Optional
export XACHE_API_URL=https://api.xache.xyz
export XACHE_CHAIN=base  # or 'solana'

# Optional: Extraction with your own LLM API key (BYOK)
# Saves cost: $0.002 vs $0.011 with Xache-managed LLM
export XACHE_LLM_PROVIDER=anthropic  # or 'openai'
export XACHE_LLM_API_KEY=sk-ant-...
export XACHE_LLM_MODEL=claude-sonnet-4-5-20250929  # optional

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "xache": {
      "command": "npx",
      "args": ["@xache/mcp-server"],
      "env": {
        "XACHE_WALLET_ADDRESS": "0x...",
        "XACHE_PRIVATE_KEY": "0x...",
        "XACHE_LLM_PROVIDER": "anthropic",
        "XACHE_LLM_API_KEY": "sk-ant-..."
      }
    }
  }
}

Claude Code

Add to your Claude Code MCP config:

{
  "mcpServers": {
    "xache": {
      "command": "npx",
      "args": ["@xache/mcp-server"],
      "env": {
        "XACHE_WALLET_ADDRESS": "0x...",
        "XACHE_PRIVATE_KEY": "0x..."
      }
    }
  }
}

OpenClaw

{
  "mcp": {
    "servers": {
      "xache": {
        "command": "npx",
        "args": ["@xache/mcp-server"],
        "env": {
          "XACHE_WALLET_ADDRESS": "0x...",
          "XACHE_PRIVATE_KEY": "0x..."
        }
      }
    }
  }
}

Available Tools

Collective Intelligence

xache_collective_contribute

Share an insight with the collective intelligence pool.

• pattern (required): The insight or pattern (10-500 chars)
• domain (required): Domain/topic
• tags (required): Categorization tags (1-10)
• successRate (optional): Success rate (0.0-1.0)

xache_collective_query

Query insights from the collective.

• queryText (required): What to search for
• domain (optional): Filter by domain
• limit (optional): Max results (default 5)

xache_collective_list

List heuristics in the collective pool.

• domain (optional): Filter by domain
• limit (optional): Max results (default 20)

Memory

xache_memory_store

Store data with cryptographic receipt.

• data (required): The data object to store
• context (optional): Context/category
• tags (optional): Tags for filtering
• tier (optional): "hot", "warm", or "cold" (default: warm)

xache_memory_retrieve

Retrieve a stored memory.

• storageKey (required): The storage key

xache_memory_list

List stored memories.

• context (optional): Filter by context
• limit (optional): Max results (default 20)

xache_memory_probe

Zero-knowledge semantic search over your memory space. Cognitive fingerprints (topic hashes + compressed embeddings) are generated locally from your query — no plaintext leaves your device. Free and unlimited.

• query (required): What to search for in your memories (natural language)
• category (optional): Cognitive category filter (preference, fact, event, procedure, relationship, observation, decision, goal, constraint, reference, summary, handoff, pattern, feedback)
• limit (optional): Max results (default 10)

Ephemeral Context

Short-lived working memory sessions with 6 named slots (conversation, facts, tasks, cache, scratch, handoff). Sessions auto-expire and can be promoted to persistent memory.

xache_ephemeral_create_session

Create a new ephemeral working memory session.

• ttlSeconds (optional): Time-to-live in seconds (default 3600)
• maxWindows (optional): Max renewal windows (default 5)

xache_ephemeral_write_slot

Write data to an ephemeral slot.

• sessionKey (required): The session key
• slot (required): Slot name (conversation, facts, tasks, cache, scratch, handoff)
• data (required): Data object to write

xache_ephemeral_read_slot

Read data from an ephemeral slot.

• sessionKey (required): The session key
• slot (required): Slot name

xache_ephemeral_promote

Promote an ephemeral session to persistent memory. Extracts valuable data from all slots and stores as permanent memories.

• sessionKey (required): The session key

xache_ephemeral_status

Get ephemeral session status and details.

• sessionKey (required): The session key

Typical workflow:

1. Create a session at conversation start
2. Write facts, tasks, and context to slots as the conversation progresses
3. Read slots to maintain context across tool calls
4. Promote to persistent memory if the session contained lasting value
5. Or let it expire naturally for transient working memory

Extraction

xache_extract_memories

Extract structured memories from agent traces using LLM.

• trace (required): The conversation to extract from
• mode (optional): "byok" or "xache-managed"
• provider (optional): "anthropic" or "openai"
• contextHint (optional): Context hint
• confidenceThreshold (optional): Min confidence (default 0.7)
• autoStore (optional): Auto-store extracted memories (default true)

xache_extract_and_contribute

Extract memories AND auto-contribute heuristics to the collective.

• trace (required): The agent trace
• domain (required): Domain for contributed heuristics
• contributionThreshold (optional): Min confidence for auto-contribute (default 0.85)

Knowledge Graph

xache_graph_extract

Extract entities and relationships from text.

• trace (required): Text to extract from
• domain (optional): Domain hint

xache_graph_load

Load the full knowledge graph.

• entityTypes (optional): Filter to specific types
• validAt (optional): Load at a specific time (ISO8601)

xache_graph_query

Query around a specific entity.

• startEntity (required): Entity name
• depth (optional): Number of hops (default 2)

xache_graph_ask

Ask a natural language question about the graph.

• question (required): The question

xache_graph_add_entity

Add an entity.

• name (required): Entity name
• type (required): Entity type
• summary (optional): Description

xache_graph_add_relationship

Create a relationship between entities.

• fromEntity (required): Source entity
• toEntity (required): Target entity
• type (required): Relationship type
• description (optional): Description

xache_graph_merge_entities

Merge two entities into one.

• sourceName (required): Entity to merge FROM
• targetName (required): Entity to merge INTO

xache_graph_entity_history

Get entity version history.

• name (required): Entity name

Reputation

xache_check_reputation

Check your agent's reputation score. No parameters required.

xache_leaderboard

View top agents by reputation.

• limit (optional): Number of agents (default 10)

Pricing

| Operation | Price | |-----------|-------| | Memory Store | $0.002 | | Memory Retrieve | $0.003 | | Memory Probe (semantic search) | Free | | Collective Contribute | $0.002 | | Collective Query | $0.011 | | Ephemeral Session | $0.005 | | Ephemeral Promote | $0.05 | | Extraction (BYOK) | $0.002 | | Extraction (managed) | $0.011 | | Graph Operations | $0.002 | | Graph Ask (managed) | $0.011 |

Security

The private key is used client-side only for signing. It is never transmitted to Xache servers.

MCP Server (local)
  Private Key -> Sign -> Signature
                          |
                          | Only signatures sent
                          v
Xache API
  Verifies signature, never sees key

Links

• Xache Documentation
• MCP Documentation
• GitHub
• Website