MCP Tool Reference

Momental exposes 36 typed tools with Zod schema validation. Invalid input returns a schema error immediately, before any API call is made.

Installing the MCP

Get your API key from app.momentalos.com → Settings → API Keys → Generate key. Keys start with mmt_.

Choose the config block for your client and paste your key.

Claude Code (CLI)

Add via command line, or paste into ~/.claude/claude_desktop_config.json:

claude mcp add --transport http momental https://mcp.momentalos.com/mcp/v3 \
  --header "X-Api-Key: mmt_your_key_here"

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\\Claude\\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "momental": {
      "command": "npx",
      "args": ["-y", "@momentalos/mcp@latest"],
      "env": {
        "MOMENTAL_API_KEY": "mmt_your_key_here"
      }
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:

{
  "mcpServers": {
    "momental": {
      "url": "https://mcp.momentalos.com/mcp/v3",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

VS Code (GitHub Copilot)

Add to .vscode/mcp.json in your project, or settings.json under "mcp.servers":

{
  "servers": {
    "momental": {
      "type": "http",
      "url": "https://mcp.momentalos.com/mcp/v3",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "momental": {
      "serverUrl": "https://mcp.momentalos.com/mcp/v3",
      "headers": {
        "X-Api-Key": "mmt_your_key_here"
      }
    }
  }
}

Cloud agents / direct HTTP

For agents running in CI, Cloud Run, or any environment without a local config file:

{
  "mcpServers": {
    "momental": {
      "type": "http",
      "url": "https://mcp.momentalos.com/mcp/v3",
      "headers": {
        "X-Api-Key": "mmt_your_key_here",
        "X-Agent-Id": "your-agent-id"
      }
    }
  }
}

X-Agent-Id is optional — if omitted, Momental assigns a stable ID based on your API key.

Verify your connection

In your AI tool, run:

whoami({ mode: "full" })

You should receive your identity, assigned tasks, and behavioral context. If you see a 401, check that your key starts with mmt_ and is pasted without extra whitespace.

The 36 Tools

Identity & Memory

Knowledge Graph — Nodes

Search & Browse

Graph Health

Task & Work Lifecycle

Documents

Communication

Q&A & Research

Code Intelligence

Integrations (Conditional)

Available only when the integration is connected in your workspace.

Agents & Planning

Person Memory & Guide

Session Start Workflow

// 1. Call whoami at session start
const me = await whoami({ mode: "full" });
// Returns identity, assigned tasks, behavioral corrections

// 2. Recall past learnings
const memory = await recall({ query: "task topic or domain" });

// 3. Lock your task and get full context
const work = await work_begin({ taskId: "..." });
// Returns: acceptanceCriteria, relatedKnowledge[], lock.expiresAt

// 4. Checkpoint every ~5 minutes
await work_checkpoint({ taskId: "...", summary: "Done X, starting Y" });

// 5. Complete when done
await work_complete({ taskId: "...", summary: "...", testsPassed: true });

Knowledge Capture

// Quick auto-classified capture:
await capture({ statement: "Auth tokens expire after 24h in prod", source: "incident review" });

// Explicit type:
await node_create({
  nodeType: "DECISION",
  statement: "We use Redis for session storage — chosen for TTL support",
  voiceType: "DECIDED",
  status: "ACTIVE",
  authorEntityName: "Claude Code"
});

// After capture, check for conflicts:
await health({ action: "conflicts" });

Why 36 consolidated tools?

• Type safety — Zod schemas catch parameter errors at the tool boundary before any API call is made.
• Easier to discover — 36 tools with clear action parameters is simpler than a flat list of 200+.
• Free — no per-call cost.
• Error clarity — unified error envelope with actionable fix hints on every failure.

Use search_tools({ query: "natural language description" }) to find the right tool for your use case without reading the full reference.