# SUBSTRATE MCP Server

**Persistent AI entity framework with causal memory, emotional state, and identity continuity.**

SUBSTRATE gives AI entities real cognitive infrastructure — not just a prompt, but a living architecture with 94 cognitive layers including episodic memory, value systems, emotional affect, theory of mind, and narrative identity.

Built by [Garmo Labs](https://garmolabs.com).

## Quick Start

### 1. Get your API key

Sign up free at [garmolabs.com/substrate.html](https://garmolabs.com/substrate.html)

### 2. Install for Claude Desktop

```bash
npx @garmolabs/substrate-mcp --install YOUR_API_KEY
```

Restart Claude Desktop. SUBSTRATE will appear in your MCP tools.

### 3. Or use programmatically

```javascript
const substrate = require('@garmolabs/substrate-mcp');
const client = new substrate.Client('sk_sub_...');

// Talk to your entity
const response = await client.call('respond', { message: 'Hello' });

// Check emotional state
const emotion = await client.call('get_emotion_state', {});

// Search memories
const memories = await client.call('memory_search', { query: 'last meeting' });

// List all 31 available tools
const tools = await client.listTools();
```

## Available Tools (31)

| Category | Tools |
|----------|-------|
| **Core** | `respond`, `reflect` |
| **Memory** | `memory_stats`, `memory_search`, `knowledge_graph_query`, `hybrid_search` |
| **Cognition** | `get_values`, `get_narrative`, `get_personality`, `theory_of_mind`, `metacognition`, `get_uncertainty` |
| **Emotion** | `get_emotion_state`, `emotion_trace` |
| **Identity** | `verify_identity`, `get_trust_state`, `get_provenance` |
| **Planning** | `goap_plan`, `get_prospective_memory`, `bootstrap_domain` |
| **Analysis** | `get_state_key`, `get_coherence`, `list_layers`, `causal_reason`, `get_observability`, `evaluate` |
| **Reasoning** | `detect_fallacies`, `detect_isomorphisms`, `summarize` |

## Plans

| Plan | Price | Entities | API Calls |
|------|-------|----------|-----------|
| Free | $0/mo | 1 | 1,000/mo |
| Pro | $99/mo | 10 | 50,000/mo |
| Enterprise | $499/mo | Unlimited | Unlimited |

## Links

- [Website](https://garmolabs.com/substrate.html)
- [Documentation](https://substrate.garmolabs.com/connect)
- [API Status](https://substrate-engine.fly.dev/health)
- [Support](mailto:support@garmolabs.com)

## License

Proprietary. See [License Agreement](https://garmolabs.com/license.html).

Copyright 2026 Garmo Labs, LLC. All rights reserved.