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)

Using pip

Configuration

Select your agent below and copy-paste the config.

Add to claude_desktop_config.json:

Run this in your terminal:

Run aider with the mcp flag:

Or add to .aider.conf.yml:

Add to ~/.gemini/settings.json:

In MCP settings, add a new server:

• Name: Sutra

• Type: command

• Command: uv tool run context-engineering-mcp

Add to your config (TOML):

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