English Français العربية

io.github.4rgon4ut/sutra

Official registry AI and agents

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package context-engineering-mcp
Claude Code 
claude mcp add sutra -- uvx context-engineering-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "sutra": {
            "command": "uvx",
            "args": [
                "context-engineering-mcp==0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Sutra
  2. Installation
  3. Configuration
  4. Core Features (v0.1.0)
  5. Development
  6. License

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

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

Frequently asked questions

What is io.github.4rgon4ut/sutra?

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

How do I install io.github.4rgon4ut/sutra?

It runs on your machine. In Claude Code: claude mcp add sutra -- uvx context-engineering-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.4rgon4ut/sutra need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.4rgon4ut/sutra open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.4rgon4ut/sutra?

It is published by 4rgon4ut. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.