Cortex MCP · v0.1.0 (beta)

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.recall call, 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_approval with a decision id resolvable via pull-mode action.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.)

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

Memory4 tools

Read and write episodic memory. Search across episodes, conversations, knowledge-graph entities, and rules with one query.

Rules4 tools

Manage the user's behavioral rulebook. Rules have a lifecycle (candidate, active, suspended, retired) and full provenance.

Trust2 tools

Inspect and graduate per-(action class × counterparty) autonomy levels. Trust is earned, never assumed.

Action10 tools

Drive the action engine. Send-class operations route through approval; safe operations execute immediately.

Briefing1 tool

On-demand briefings synthesized from memory, calendar, and rule state.

Entity2 tools

Resolve canonical entities (people by default; pluggable types per ADR-0018) and walk their relationships.

Handler6 tools

Register, list, update, and rotate secrets for the customer-owned HTTPS handlers that receive Cortex-dispatched triggers. Per ADR-0019.

Trigger3 tools

Inspect dispatched triggers, view delivery history, and replay from the dead-letter queue. The outbound complement to action.* (pull-mode).

Routing6 tools

Choose which registered handler receives a trigger when a user has multiple AI products built on Cortex. The cross-app routing layer (V1.1).

Meta3 tools

Explainability surface — render "why did Cortex suggest this?" with substrate-grounded provenance. Promoted to public per ADR-0021.

Decision2 tools

Generalized decision inspection across triage, action_proposed, rule_fired, trust_transition. Per ADR-0021 §read-API.

Counterparty5 tools

Per-counterparty trust graph as a callable read surface — profile, list, activity, classify, trust posture. The moat API.

Commitments5 tools

Tracked promises with a lifecycle state machine. Auto-extracted from messages and meetings via consolidation; explicit writes route through the action engine.

Action Classes3 tools

Customer-extensible action classes per ADR-0022. Register {client_namespace}.{action_class} for your vertical without internal enum migrations.

Subscriptions5 tools

Inbound interest declaration — subscriptions, watchlists, alerts. Evaluator polled at 5-min cadence MVP; event-hooked V1.1+.

Feedback1 tool

Modification learning channel. feedback.signal + trigger.complete executed_modified outcome (ADR-0019 amendment) feed the per-counterparty learning hook.

Patterns1 tool

Read the rule-candidate / pattern-detector surface produced by consolidation Phase 2.

Insights1 tool

Narrative summarization on demand. V1.1+ — stub-ships at MVP.

Identity2 tools

Principal's identity model surface (roles, values, goals, constraints). identity.about_me live MVP; preferences V1.1+.

Availability1 tool

Principal's current availability state (focus / shielding / meeting). V1.1+ — stub-ships at MVP.

Agent3 tools

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.