Sutra

mcp-name: io.github.4rgon4ut/sutra

The MCP Context Engineering Engine

Sutra is a Model Context Protocol (MCP) server that transforms how LLMs handle reasoning, memory, and orchestration. It provides a "Standard Library" of cognitive tools (Thinking Models), memory structures (Cells), and multi-agent patterns (Organs).

Installation

Using uv (Recommended)

uv tool install context-engineering-mcp

Using pip

pip install context-engineering-mcp

Configuration

Select your agent below and copy-paste the config.

<details> <summary>Claude Desktop</summary>

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "sutra": {
      "command": "uv",
      "args": ["tool", "run", "context-engineering-mcp"]
    }
  }
}

</details>

<details> <summary>Claude Code</summary>

Run this in your terminal:

claude mcp add sutra uv tool run context-engineering-mcp

</details>

<details> <summary>Aider</summary>

Run aider with the mcp flag:

aider --mcp "uv tool run context-engineering-mcp"

Or add to .aider.conf.yml:

mcp: ["uv tool run context-engineering-mcp"]

</details>

<details> <summary>Gemini CLI</summary>

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "sutra": {
      "command": "uv",
      "args": ["tool", "run", "context-engineering-mcp"]
    }
  }
}

</details>

<details> <summary>Cursor / Windsurf</summary>

In MCP settings, add a new server:

• Name: Sutra
• Type: command
• Command: uv tool run context-engineering-mcp </details>

<details> <summary>Codex</summary>

Add to your config (TOML):

[mcp_servers.sutra]
command = "uv"
args = ["tool", "run", "context-engineering-mcp"]

</details>

Core Features (v0.1.0)

1. The Gateway (Router)

Sutra automatically analyzes your request to decide the best strategy:

• YOLO Mode: For immediate tasks ("Fix this bug"), it routes to specific cognitive tools.
• Constructor Mode: For system design ("Build a bot"), it routes to the Architect.

2. The Architect

Generates blueprints for custom agents, combining:

• Thinking Models: understand_question, verify_logic, backtracking, symbolic_abstract.
• Memory Cells: key_value (State), windowed (Short-term), episodic (Long-term).
• Organs: debate_council (Multi-perspective), research_synthesis (Deep Dive).

3. The Librarian

A manual discovery tool (get_technique_guide) that lets you or the agent browse the full catalog of Context Engineering techniques.

Development

Requirements: Python 3.10+, uv (optional but recommended).

1. Clone the repo:

   git clone https://github.com/4rgon4ut/sutra.git
   cd sutra
   

2. Install dependencies:

   uv sync --all-extras
   # OR
   pip install -e ".[dev]"
   

3. Run tests:

   pytest
   

License

MIT