MCP and Agent Workflows¶

otito can run as a stdio MCP server so agent hosts can ask for repository context without scraping terminal output.

Start The Server¶

The npm package is not published yet. Start from a local checkout:

git clone https://github.com/BASHBOP/otito.git
cd otito && npm ci
node src/cli.js doctor

node src/cli.js mcp

From a local checkout:

node src/cli.js mcp

The MCP server uses stdio. The agent host starts otito mcp as a child process and speaks JSON-RPC over standard input and output.

MCP Client Examples¶

Use the checkout path until npm publication. After installation, the otito binary can replace the node command below.

Generic stdio client¶

Many MCP clients use this shape:

{
  "mcpServers": {
    "otito": {
      "command": "node",
      "args": ["/absolute/path/to/otito/src/cli.js", "mcp"],
      "env": {}
    }
  }
}

Some hosts also require an explicit "type": "stdio" field. Check the host's current MCP schema before copying a config into a shared repository.

For a local checkout instead of a global install:

{
  "mcpServers": {
    "otito": {
      "command": "node",
      "args": ["/path/to/otito/src/cli.js", "mcp"],
      "env": {}
    }
  }
}

Keep /path/to/otito as a private local path. Do not commit machine-specific absolute paths to public documentation or shared repositories.

Claude Desktop¶

Claude Desktop uses claude_desktop_config.json with a top-level mcpServers object.

{
  "mcpServers": {
    "otito": {
      "type": "stdio",
      "command": "otito",
      "args": ["mcp"],
      "env": {}
    }
  }
}

After editing the config, fully restart Claude Desktop. If the server does not appear, run otito doctor and otito mcp manually in a terminal first, then check the MCP logs for the host.

Reference: Model Context Protocol local server guide.

VS Code¶

VS Code stores MCP server configuration in mcp.json. Workspace-level configuration lives at .vscode/mcp.json; user-level configuration is also supported by VS Code.

VS Code uses a top-level servers object:

{
  "servers": {
    "otito": {
      "type": "stdio",
      "command": "otito",
      "args": ["mcp"]
    }
  }
}

Useful commands from the Command Palette:

• MCP: Add Server
• MCP: List Servers
• MCP: Reset Cached Tools
• MCP: Open Workspace Folder MCP Configuration
• MCP: Open User Configuration

Reference: VS Code MCP configuration reference.

Cursor¶

Cursor uses mcp.json with a top-level mcpServers object.

{
  "mcpServers": {
    "otito": {
      "command": "otito",
      "args": ["mcp"],
      "env": {}
    }
  }
}

Use a project config when otito should only be available for one workspace. Use a global config only when you want the server available across projects.

Reference: Cursor MCP docs.

MCP Tool Surface¶

Òtítọ́ exposes 13 MCP tools for deterministic repository context and merge evidence.

Agent Loop¶

Host Guidance¶