Sutra

io.github.4rgon4utPublished by GitHub account 4rgon4utv0.1.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyKnowledge & MemoryAI & ML

Overview

AI-generated overview

Sutra is a local MCP server that gives an assistant a library of reasoning techniques, memory structures and multi-agent patterns for context engineering.

What you can do
Route requests to reasoning strategies such as YOLO mode for immediate tasks and Constructor mode for system design, with an Architect that generates blueprints for custom agents using thinking models, memory cells and organs such as debate council and research synthesis. Browse the catalog of context engineering techniques with a manual discovery tool. Apply thinking models such as question understanding, logic verification, backtracking and symbolic abstraction. Use memory cells for key-value state, short-term windowed memory and long-term episodic memory.
When to use it
Useful when you want an assistant to structure its own reasoning, keep state across a session, or design custom agent workflows rather than call an external service.
Requirements
Runs as a local process on the user's machine (desktop only). Requires Python 3.10+ and the PyPI package context-engineering-mcp, installed with uv or pip; uv is optional but recommended. No accounts, API keys or environment variables are declared.
Before you install
The server is early-stage (features listed for v0.1.0) and its tools are not enumerated in the manifest, so review what it exposes before relying on it. It stores memory structures locally; check where that data is kept.

Installation

In SourceWeft

  1. Open Sutra in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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)

bash
uv tool install context-engineering-mcp

Using pip

bash
pip install context-engineering-mcp

Configuration

Select your agent below and copy-paste the config.

Claude Desktop

Add to claude_desktop_config.json:

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

Run this in your terminal:

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

Run aider with the mcp flag:

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

Or add to .aider.conf.yml:

yaml
mcp: ["uv tool run context-engineering-mcp"]
Gemini CLI

Add to ~/.gemini/settings.json:

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):

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:
    bash
    git clone https://github.com/4rgon4ut/sutra.gitcd sutra
  2. Install dependencies:
    bash
    uv sync --all-extras# ORpip install -e ".[dev]"
  3. Run tests:
    bash
    pytest

License

MIT

Source: README.md at commit c0a1d4c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts