mcpField
S
sutra

sutra

Local
github.com/4rgon4utAI & Agents0Updated 43w ago
Repository

About sutra

sutra is an MCP context-engineering server for LLM developers building agents. It combines request routing, agent blueprint generation, memory structures, and a catalog of techniques.

Key features

  1. 01Routes requests by task strategy
  2. 02Generates custom agent blueprints
  3. 03Provides multiple thinking models
  4. 04Supports varied memory structures
  5. 05Browses context-engineering techniques

Use cases

  1. 01Select cognitive tools for immediate tasks
  2. 02Plan a custom agent's structure
  3. 03Combine debate and research synthesis
  4. 04Find context-engineering techniques

MCP support

sutra is an MCP server that exposes request routing, agent blueprint generation, and technique-guide discovery to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "4rgon4ut-sutra": {
      "command": "uvx",
      "args": [
        "context-engineering-mcp"
      ]
    }
  }
}
Run commanduvx context-engineering-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypicontext-engineering-mcp0.1.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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)
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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.