Back to Directory/Developer Tools

io.github.4rgon4ut/sutra

Context Engineering Engine. Provides cognitive tools, memory structures, and agent patterns.

Developer ToolsPythonv0.1.1

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.

Claude Desktop

Add to claude_desktop_config.json:

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

Run this in your terminal:

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

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"]
Gemini CLI

Add to ~/.gemini/settings.json:

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

In MCP settings, add a new server:

  • Name: Sutra
  • Type: command
  • Command: uv tool run context-engineering-mcp
Codex

Add to your config (TOML):

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

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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx context-engineering-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-4rgon4ut-sutra": {
      "command": "uvx",
      "args": [
        "context-engineering-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

context-engineering-mcppypi

Compatible MCP Clients

io.github.4rgon4ut/sutra works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More