
Official Python/TypeScript SDK & MCP bridge for Exogram (exogram.ai) — the Personal AI Agent and
Official Python/TypeScript SDK & MCP bridge for Exogram (exogram.ai) — the Personal AI Agent and workspace for your work, people, and life.
·
v0.2.0)
Exogram (exogram.ai) is a Personal AI Agent and workspace that understands your whole story across your work, people, and everyday life—coordinating specialist agents, turning plain requests into finished interactive deliverables, and executing real tasks with your approval.
This open-core repository provides the official Python/TypeScript SDKs and MCP bridge (mcp-server-exogram) so external AI tools (Claude, Cursor, Windsurf, VS Code, Google Antigravity) can connect directly into that same Exogram Personal Neural Network, interactive widget engine, and action-approval guardrails.
This open-core repository ships the runnable client libraries, local SQLite WAL engine, FastMCP server, and A2UI Living Tile JSON schemas:
python/ (exogram v0.2.0) — Python SDK with Zero-Signup Local SQLite WAL Mode (~/.exogram/vault.db) and Cloud API routing (https://api.exogram.ai).typescript/ (@exogram/sdk v0.2.0) — TypeScript & Node.js SDK with CJS/ESM/DTS builds and zero-signup local mode.mcp-server/ (mcp-server-exogram v0.2.0) — FastMCP Server for Claude Desktop, Cursor, Google Antigravity, and OpenAI Agents.schemas/living-tiles-v5.schema.json — Canonical JSON Schema for all Composable A2UI Living Tiles and the 6 First-Party Kernels.Every SDK and MCP tool runs immediately on your machine using an embedded SQLite WAL vault (~/.exogram/vault.db) with zero account signup or API key required. When you set EXOGRAM_API_KEY, the exact same code routes to Exogram Cloud (https://exogram.ai).
pip install exogram
# Or install directly from source:
pip install git+https://github.com/Richard-Ewing/exogram-sdk.gitfrom exogram import ExogramClient
# Automatically initializes ~/.exogram/vault.db (SQLite WAL) when no API key is set,
# or routes to https://api.exogram.ai when api_key="exo_live_..." or EXOGRAM_API_KEY is set.
client = ExogramClient()
# 1. Store memory claims across Work, People, and Life spheres
record = client.vault.store(
"Architecture decision: Production edge deploys to Cloudflare Workers via OpenNext",
namespace="work",
sphere="Work",
confidence=0.98,
temporal_horizon="durable_trait",
)
print(f"Stored {record.id} | State Hash: {record.state_hash}")
# 2. Traverse the Personal Neural Network (Infinite-Hop Spreading Activation + HippoRAG 2 PPR)
context = client.neural_network.retrieve(
query="How does our production edge deploy?",
spheres=["Work", "People", "Life"],
max_hops=4,
)
print(f"PPR Converged: {context.ppr_converged} | Claims: {len(context.claims)}")
# 3. Deterministic 0.07ms State-Hash & Instinct Pre-Mutation Action Gate
judgment = client.governance.evaluate_action(
agent_id="deployment-sentinel",
action_type="deploy_cloudflare_worker",
parameters={"service": "exogram-edge", "environment": "production"},
state_hash=context.state_hash,
)
if judgment.permitted:
receipt = client.actions.execute(judgment.execution_token)
print(f"Committed! Ledger Hash: {receipt.ledger_hash}")Or run the self-contained demo script directly from this repository:
python examples/quickstart_local_and_cloud.py<30s)~/.exogram/vault.db){
"mcpServers": {
"exogram": {
"command": "uvx",
"args": ["mcp-server-exogram", "--local"]
}
}
}https://exogram.ai/api/mcp){
"mcpServers": {
"exogram": {
"command": "uvx",
"args": ["mcp-server-exogram"],
"env": {
"EXOGRAM_API_KEY": "exo_live_your_key_here",
"EXOGRAM_API_URL": "https://api.exogram.ai"
}
}
}
}@exogram/sdk)npm install @exogram/sdkimport { ExogramClient } from '@exogram/sdk';
const client = new ExogramClient(); // Zero-signup local mode or pass { apiKey: process.env.EXOGRAM_API_KEY }
const rec = await client.vault.store('Deploy target is Cloudflare Workers Global Edge', {
namespace: 'work',
sphere: 'Work',
confidence: 0.96,
});
const context = await client.neuralNetwork.retrieve('What is our deploy target?', {
spheres: ['Work', 'People', 'Life'],
maxHops: 4,
});
const judgment = await client.governance.evaluateAction({
agentId: 'ts-agent',
actionType: 'deploy_worker',
parameters: { target: 'cloudflare' },
stateHash: context.stateHash,
});
if (judgment.permitted && judgment.executionToken) {
const receipt = await client.actions.execute(judgment.executionToken);
console.log('Committed Ledger Hash:', receipt.ledgerHash);
}┌──────────────────────────────────────────────────────────────────────────────┐
│ User Prompt / External MCP Agent Call │
└──────────────────────────────────────┬───────────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────────────────────┐
│ 1. Laya System 1 Deterministic Fast-Path (<15ms In-Memory Understanding) │
│ Resolves vault subjects, intent, sphere routing (Work · People · Life), │
│ and search queries in <15ms over profileDigest + priorTurns. │
└──────────────────────────────────────┬───────────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────────────────────┐
│ 2. Personal Neural Network (Infinite-Hop Spreading Activation + HippoRAG 2) │
│ • Hybrid RRF Retrieval (Vector + BM25 + Entity Overlap) │
│ • Personalized PageRank (PPR, damping α = 0.85) across multi-hop edges │
│ • 3-Horizon Episodic Memory (ephemeral_episode, recurring_event, durable) │
│ • Read-Time/Write-Time Scalar Conflict Supersession & /api/memory/undo │
└──────────────────────────────────────┬───────────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────────────────────┐
│ 3. Two-Tier Inference Gateway & 6 Honest First-Party Kernels │
│ • PERSONAL Subtasks → Paid Gemini 3.x (Zero PII leaves encrypted boundary)│
│ • PUBLIC_ONLY Subtasks → PII-stripped & compressed before Free-Token Pool │
│ • Post-Synthesis Citation Verification (Complete · Cited vs Standby) │
└──────────────────────────────────────┬───────────────────────────────────────┘
▼
┌──────────────────────────────────────────────────────────────────────────────┐
│ 4. Instinct Pre-Mutation Governance (0.07ms Gate) & A2UI Living Tiles │
│ • Deterministic SHA-256 State-Hash Drift Guard before any tool mutation │
│ • Progressive JSON Patching (AG-UI) & Claim-Predicate Entailment Scoring │
└──────────────────────────────────────────────────────────────────────────────┘Every turn is orchestrated by six specialized first-party kernels and audited by verifyAgentContributionsAgainstTurnOutput so only kernels whose outputs are genuinely cited in the final synthesis display Complete · Cited:
| Kernel | Responsibility |
|---|---|
Neural Graph Kernel | Traverses multi-hop associative paths across Work, People, and Life using Spreading Activation and HippoRAG 2 Spectral PPR. |
Generative UI Kernel | Synthesizes and validates Composable A2UI Living Tiles against schemas/living-tiles-v5.schema.json. |
Live Web & Places Scout | Executes PII-stripped public web & place verification for PUBLIC_ONLY subtasks. |
Action & Draft Kernel | Prepares governed emails, calendar events, and external tool mutations gated by the 0.07ms Instinct Action Gate. |
Analytical Synthesis Kernel | Performs multi-constraint reasoning, tradeoff matrices, and structured comparisons. |
Grounded Citation Kernel | Enforces contrastive claim-predicate entailment (scoreClaimPredicateEntailment) and Perplexity-style [1], [2] citations. |
schemas/living-tiles-v5.schema.json)Exogram dispatches structured inline Living Tiles validated for epistemic provenance:
action_draft — Governed outbound drafts (email, message, calendar, PR) with approval controls.checklist — Interactive execution checklists anchored to vault goals.decision_matrix — Multi-criteria weighted scoring tables.curated_places — Grounded venue & location cards with verified ratings.comparison_table — Side-by-side technical or product breakdowns.retail_deals_tile — Verified merchant pricing and availability cards.media_watch_tile — Film, series, book, and podcast recommendations with streaming provenance.occasion_countdown_tile — Recurring event (RRULE:FREQ=YEARLY) countdowns and preparation steps.memory_undo_tile — Transparent memory consolidation card with one-click /api/memory/undo.agent_hud_tile — Real-time telemetry of the 6 First-Party Kernels (Complete · Cited vs Standby).branded_diagram_tile — Publication-grade Plum Mineral (#FAF7F2, #201B20, #4C2B4B, #AEBD9A) SVG diagrams.hyperframes_video_tile — Frame-accurate deterministic HTML/CSS/SVG motion briefings (window.__renderFrame).instinct_computer_tile — Stateful browser/errand operator HUD with Approve Step and Take Over controls.exogram-sdk/
├── python/ # Official Python SDK (pip install exogram)
├── typescript/ # Official TypeScript SDK (npm install @exogram/sdk)
├── mcp-server/ # FastMCP Server (uvx mcp-server-exogram)
├── schemas/ # JSON Schemas (living-tiles-v5.schema.json)
├── examples/ # Runnable Local & Cloud Quickstart scripts
└── docs/assets/ # Plum Mineral UI previews & architecture diagrams# 1. Run the 60-second quickstart script
python examples/quickstart_local_and_cloud.py
# 2. Run Python SDK unit tests
pytest python/tests/
# 3. Run FastMCP Server unit tests
pytest mcp-server/tests/
# 4. Run TypeScript SDK unit tests
cd typescript && npm testMIT — see LICENSE for details.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add exogram -- uvx mcp-server-exogram --local{
"mcpServers": {
"exogram": {
"args": [
"mcp-server-exogram",
"--local"
],
"command": "uvx"
}
}
}code --add-mcp '{"name":"exogram","args":["mcp-server-exogram","--local"],"command":"uvx"}'[mcp_servers.exogram]
command = "uvx"
args = ["mcp-server-exogram", "--local"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/exogram-sdk to learn what the "Exogram Sdk" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
pip install exogram
pip install git+https://github.com/Richard-Ewing/exogram-sdk.git| Name | What it does |
|---|---|
search_vault | Semantic and keyword search across stored personal records, facts, and memories in the private vault. |
search_memory_vault | Search the Exogram Personal Neural Network and encrypted memory vault across facts, people, preferences, and commitments. |
store_memory | Anchor a new fact, code convention, project invariant, or personal memory to your encrypted vault. |
update_memory_vault | Persist or supersede a personal fact, commitment, or preference in your encrypted Exogram memory vault. |
get_neural_cluster | Look up an entity in Exogram's Layer 2 Knowledge Graph. Returns connected entities and directional relationships. |
list_entities | Retrieve active entities and concepts mapped in the personal knowledge network. |
check_action_safety | Verify whether an agent action is safe and complies with active execution invariants before running. |
record_decision | Record an execution decision into the tamper-evident cryptographic audit ledger. |
verify_audit_trail | Verify the cryptographic SHA-256 hash chain integrity of the ledger from genesis to head. |
query_graph | Ask a natural language question against the knowledge graph and receive a structured answer with entity paths and gap analysis. |
gmail_search_messages | Search personal or workspace emails via Gmail API with query syntax (read-only). |
gmail_create_draft | Create an email draft in Gmail. Does NOT send the email without explicit user confirmation. |
drive_search_files | Search documents, presentations, and files in Google Drive (read-only). |
drive_create_presentation | Create a new Google Slides presentation draft with structured slides. |
calendar_list_events | List upcoming meetings, agenda items, and schedule availability from Google Calendar (read-only). |
calendar_create_meeting | Draft a new Google Calendar meeting invite. Does NOT send invites without explicit user confirmation. |
github_search_issues | Search issues and pull requests across connected GitHub repositories (read-only). |
github_create_pr_draft | Draft a GitHub Pull Request proposal. Does NOT open or publish the PR without explicit user approval. |
notion_search_pages | Search pages and databases in the user connected Notion workspace. |
notion_append_block | Draft new content or notes to append into an existing Notion page. Gated by explicit user approval. |
slack_list_channels | List accessible channels in the connected Slack workspace. |
slack_post_message_draft | Draft a message to a Slack channel. Does NOT post without explicit user approval. |
| Name | What it does |
|---|---|
exogram_context_brief | Gather relevant background across your work, people, and life priorities before drafting or deciding. |
exogram_action_plan | Turn a plain-English goal into an approval-gated plan grounded in your Exogram context and safety checks. |
| Name | What it does |
|---|---|
Personal Vault Summary | High-level overview of stored memories and user context in Exogram. |
Knowledge Graph Entities | Current topological entity nodes and relationship categories. |
Read live from the server on November 15, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/exogram-sdk)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "exogram-sdk" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.