SUBSTRATE
Persistent AI entity framework with causal memory, emotional state, and identity.
Open source Repository Open in the app JSON README (API)
About
Persistent AI entity framework with causal memory, emotional state, and identity.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- pkaldone
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.1
- Last push
- 2026-03-29T06:21:04Z
- Repository state
- ativo
- Language
- JavaScript
- License
- NOASSERTION
- Added
- 2026-08-29 03:02:09
- Updated
- 2026-08-29 03:02:09
- Origin id
io.github.PKaldone/substrate
README
# 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.