Name: Angreal
Author: angreal

LABSCO SUMMARY

Three tools to find, read and run your Angreal tasks.

This is the standalone angreal_mcp binary, not the angreal mcp command built into Angreal itself. It gives the assistant three tools: check that the folder is an Angreal project, list the command tree with its when-to-use guidance, and run a command. The README suggests using them in that order.

What it is

A standalone MCP server for Angreal projects, installed from crates.io as angreal_mcp. The client launches the angreal_mcp binary as a stdio subprocess, and it lets the assistant discover, inspect and run the commands and tasks defined in your project.

What you get

angreal_check confirms the current directory is an Angreal project and reports its status and available commands
angreal_tree returns the command tree as JSON (default) or human-readable text, with when_to_use and when_not_to_use guidance
angreal_run executes a command or task, with optional arguments and flags
JSON-RPC 2.0 over stdio, started and stopped by the client rather than run by hand

Requirements

Angreal installed and on your PATH, and the Rust toolchain to run cargo install angreal_mcp. The server has to start inside an Angreal project (a folder with .angreal/), so the Claude Desktop and Cline configs set cwd to the project.

Setup effort

One command — cargo install angreal_mcp

See installation options

USE CASES

01

Stopping an assistant from improvising shell commands

With angreal_tree listing the project's commands, it runs them through angreal_run rather than assembling a shell invocation of its own.

02

Choosing the right task before running it

Read the when_to_use and when_not_to_use guidance angreal_tree returns before running anything.

03

Checking you are in an Angreal project

Call angreal_check to confirm the folder is an Angreal project and see which commands it offers.

04

Wiring it up for the whole repository at once

Set the client's cwd to the project (Cline can use ${workspaceFolder}) so angreal_mcp starts where the .angreal/ folder is.

3 tools

Listed in project docs. Your client may show a different list.

angreal_check

angreal_tree

angreal_run

BEFORE YOU INSTALL

What to know first

Tools you get

3 tools named in the project's documentation.

Requires

angreal_mcp on PATH

Where it runs

All 3 documented clients run the server on your machine.

INSTALLATION

Connect your client

Server setup

TERMINAL

cargo install angreal_mcp

MCP Clients

Claude Code

CLAUDE CODE · JSON

{
  "mcpServers": {
    "angreal": {
      "command": "angreal_mcp",
      "args": [],
      "env": {}
    }
  }
}

Claude Desktop

CLAUDE DESKTOP · JSON

{
  "mcpServers": {
    "angreal": {
      "command": "angreal_mcp",
      "args": [],
      "cwd": "<YOUR_PATH_TO_ANGREAL_PROJECT>"
    }
  }
}

Cline

CLINE · JSON

{
  "mcpServers": {
    "angreal": {
      "command": "angreal_mcp",
      "args": [],
      "cwd": "${workspaceFolder}"
    }
  }
}