Skip to content
Oka Docs

Reason — MCP tools

Reason is Oka’s institutional intelligence layer. It exposes 19 tools over the Model Context Protocol that any MCP-compatible client can call — Claude Desktop, Claude Code, Cursor, Windsurf, VS Code Copilot, Codex, Cline, Zed, Amazon Q, Continue.dev, JetBrains, Hermes, and any other MCP client.

Auth tools (2)

ToolPurpose
loginAuthenticate via browser — opens id.oka.so, stores token locally
whoamiCheck current authentication status

No API key needed in your config. Just connect and call login to authenticate. See authentication details.

Write tools (7)

Agents emit structured friction events as they work:

ToolPurpose
observeRecord a fact, pattern, or friction point
decisionCapture a choice with rationale and alternatives
exploreRecord findings from investigating a codebase area
deviationNote where reality diverged from the plan
doneMark a task as complete with outcome signals
learningDistill an insight worth remembering across sessions
feedbackReport whether a learning was useful (trains ranking)

Every event is attributed, timestamped, and linked to a workspace. Full write tools reference →

Read tools (10)

Query accumulated organizational intelligence:

ToolPurpose
contextRanked institutional knowledge for a topic (flagship)
learningsBrowse by category, status, confidence
decisionsQuery the organizational decision log
patternsSurface recurring behaviors across sessions
semantic_searchFree-text vector search
suggestEvidence-ranked backlog suggestions
backlogAuto-generated PBIs from friction patterns
prioritiesApproved high-confidence work items
consolidateTrigger manual consolidation
entitiesQuery the typed ontology graph

Full read tools reference →

Connecting a client

Any MCP-compatible client

Add Oka to your MCP config — no API key required:

{
  "mcpServers": {
    "oka": {
      "command": "npx",
      "args": ["-y", "@oka-core/reason"]
    }
  }
}

Once connected, call the login tool to authenticate via your browser. Your token is stored locally and refreshes automatically.

For headless/CI environments, set OKA_API_KEY instead:

{
  "mcpServers": {
    "oka": {
      "command": "npx",
      "args": ["-y", "@oka-core/reason"],
      "env": { "OKA_API_KEY": "sk_..." }
    }
  }
}

Client-specific guides: Claude Code · Cursor · Windsurf · VS Code Copilot · Codex CLI · Cline · Zed · Amazon Q · Continue.dev · JetBrains · Hermes

Next steps