The cognitive substrate that decides. Your stack executes.
Cortex exposes memory, rules, trust, action, and dispatch over the Model Context Protocol. Connect any MCP client to pull state (Claude Desktop, Cursor, Continue, your own agent), or register a handler and let Cortex push you signed triggers when its substrate decides an action should happen. Same backend, two shapes — earns the right to act per user, per counterparty, per action class.
The push model in 60 seconds
Register a handler URL once. When Cortex decides an action should happen (rule fires, trust threshold crossed, commitment going stale, pattern matched), it HMAC-signs an envelope and POSTs to your URL. You verify the signature, execute through your app's native channels, and call back. Trust compounds per (user × counterparty × action class). Full contract: Trigger dispatch and the framework recipes at Recipes (Trigger.dev, n8n, Zapier, custom-webhook, MCP-executor).
What you get
Five primitives, callable over one protocol, with full provenance and a per-(action class × counterparty) trust ledger underneath:
- Memory. A unified retrieval surface across episodes, conversations, knowledge-graph entities, and rules. One
memory.recallcall, ranked results. - Rules. A behavioral rulebook with lifecycle —
candidate,active,suspended,retired. New rules require user confirmation by design, so the rulebook can't be poisoned by prompt injection. - Trust. Earned per-pair autonomy, not a global “trust this AI” switch. Read the current level, graduate a pair you've earned, and let reversals demote it automatically.
- Action. Send-class operations route through the action engine and either execute, return
pending_approvalwith a decision id resolvable via pull-modeaction.approve/action.reject, or dispatch a trigger to your registered handler (push-mode). - Dispatch. Register a handler URL, receive signed triggers when the substrate decides, call back
trigger.complete/trigger.reverse. ADR-0019. The push complement to the four pull primitives above.
One-minute connect
Point Claude Desktop, Cursor, or any MCP-capable client at the local dev server. (Full setup with token issuance in the Quickstart.)
{
"mcpServers": {
"cortex": {
"url": "http://localhost:3002/mcp",
"headers": {
"Authorization": "Bearer YOUR_MCP_BEARER_TOKEN"
}
}
}
}The surface, today
70 tools across the full vision — 44 live in code today, 12 ship July 20, 2026 (action approval + trigger dispatch), 8 ship V1.x+ (cross-app routing engine, narrative summarization, identity preferences, additional feedback signal kinds), and 1 ship V2 (Trusted Delegate, full delegate flows). No MCP resources or prompts — this surface is tools-only by design.
The substrate read API (added 2026-05-27 evening per explainability, counterparty depth, commitments, patterns, identity, capability discovery, subscriptions, routing read-preview, feedback learning, extension action classes) is what makes the cognitive-substrate positioning externally verifiable. The runtime self-description is agent.capabilities(); pitch docs match it via the sync rule. Per ADR-0021 + ADR-0022.
Read and write episodic memory. Search across episodes, conversations, knowledge-graph entities, and rules with one query.
Manage the user's behavioral rulebook. Rules have a lifecycle (candidate, active, suspended, retired) and full provenance.
Inspect and graduate per-(action class × counterparty) autonomy levels. Trust is earned, never assumed.
Drive the action engine. Send-class operations route through approval; safe operations execute immediately.
On-demand briefings synthesized from memory, calendar, and rule state.
Resolve canonical entities (people by default; pluggable types per ADR-0018) and walk their relationships.
Register, list, update, and rotate secrets for the customer-owned HTTPS handlers that receive Cortex-dispatched triggers. Per ADR-0019.
Inspect dispatched triggers, view delivery history, and replay from the dead-letter queue. The outbound complement to action.* (pull-mode).
Choose which registered handler receives a trigger when a user has multiple AI products built on Cortex. The cross-app routing layer (V1.1).
Explainability surface — render "why did Cortex suggest this?" with substrate-grounded provenance. Promoted to public per ADR-0021.
Generalized decision inspection across triage, action_proposed, rule_fired, trust_transition. Per ADR-0021 §read-API.
Per-counterparty trust graph as a callable read surface — profile, list, activity, classify, trust posture. The moat API.
Tracked promises with a lifecycle state machine. Auto-extracted from messages and meetings via consolidation; explicit writes route through the action engine.
Customer-extensible action classes per ADR-0022. Register {client_namespace}.{action_class} for your vertical without internal enum migrations.
Inbound interest declaration — subscriptions, watchlists, alerts. Evaluator polled at 5-min cadence MVP; event-hooked V1.1+.
Modification learning channel. feedback.signal + trigger.complete executed_modified outcome (ADR-0019 amendment) feed the per-counterparty learning hook.
Read the rule-candidate / pattern-detector surface produced by consolidation Phase 2.
Narrative summarization on demand. V1.1+ — stub-ships at MVP.
Principal's identity model surface (roles, values, goals, constraints). identity.about_me live MVP; preferences V1.1+.
Principal's current availability state (focus / shielding / meeting). V1.1+ — stub-ships at MVP.
Self-describing surface — agent.version, agent.capabilities, agent.feature_flags. The runtime truth that pitch docs must match.
Designed around what we won't expose
The public surface is deliberately narrow. Tools that mutate user OAuth credentials, manage third-party connector lifecycles, edit rules without user confirmation, or expose raw memory without trust gating are not on this server. They exist for Cortex's own agent runtime and are unreachable from this endpoint. See Governance boundary for the full list.
Where to go next
- Quickstart — connect a real client in five minutes.
- Authentication — how bearer tokens work today, OAuth for MVP.
- Core concepts — the five primitives, the action-approval ceremony, and the entity model.
- Trigger dispatch — the push contract: envelope, signing, callbacks, retry, DLQ, three handler tiers.
- Recipes — copy-paste handler implementations for Trigger.dev, n8n, Zapier, custom webhooks, and (V1.1) MCP-executor.
- Tool reference — every tool with its input schema, output shape, errors, and a runnable example.