Connect via MCP
Give any MCP-capable AI access to your Stateful context.
Stateful exposes your knowledge graph as a Model Context Protocol (MCP) server. Any AI that supports MCP — Claude.ai, Cursor, Claude Code, and more — can pull your context on demand.
Endpoint
Auth
Stateful uses OAuth 2.0. When you connect a new AI client, it registers itself and walks you through a standard consent flow — you grant it a token with the scopes you choose. There's nothing to paste by hand.
| Scope | What it allows |
|---|---|
stateful:read | Read your context and search your subjects |
stateful:write | Propose new facts or edits (which still require your approval) |
Tools
The MCP server exposes six tools.
get_context
Retrieves a relevant slice of your knowledge graph for the current conversation. Pass the user's actual question as query so Stateful can surface the right facts.
remember
Stages a fact for your review. Nothing is saved until you approve it in your inbox.
kind is one of: fact, preference, decision, goal, constraint, rejection, correction.
search_subjects
Search your knowledge graph by keyword or meaning.
read_subject
Read the full page for one subject. Pass a subject's name, or a key returned by search_subjects.
propose_subject_edit
Propose an edit to an existing subject page. The edit lands in your inbox for approval.
propose_new_subject
Propose creating a new subject page. Also goes to your inbox for approval.
Connecting Claude.ai
- In Claude.ai, open Settings → Connectors (you'll need a plan that supports custom connectors).
- Add a custom connector with the URL
https://mcp.stateful.me/mcp/. - Authorize the OAuth flow.
- Claude can now call
get_context,remember, and the rest in any conversation.
The one rule that matters
However you connect an AI, the single most important behavior is this: call get_context before answering anything about you — and pass the user's real question as the query, not a generic string. That's what makes the AI ground its answer in your actual context instead of guessing.