@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

``bash
npm install -g @xache/mcp-server
`

Or run directly:
`bash
npx @xache/mcp-server
`

Configuration

$3

`bash


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
`

$3

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

`json
{
"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-..."
}
}
}
}
`

$3

Add to your Claude Code MCP config:

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

$3

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

Available Tools

$3

#### 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)

$3

#### 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)

$3

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

$3

#### 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)

$3

#### 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

$3

#### 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 |
| 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