Heed MCP Server

Human approval as a native agent tool. Exposes the Heed HITL API over MCP so Claude Code, Cursor, and any MCP-compatible agent can pause for human sign-off before risky actions.

Install

pip install heed-mcp

Or without installing globally:

uvx heed-mcp

Tools

Configuration

Claude Code setup

pip install heed-mcp
claude mcp add heed \
  -e HEED_API_KEY=hd_live_your_key_here \
  -e HEED_BASE_URL=https://heed.run \
  -- heed-mcp

Or add to .mcp.json in your project:

{
  "mcpServers": {
    "heed": {
      "command": "heed-mcp",
      "env": {
        "HEED_API_KEY": "hd_live_your_key_here",
        "HEED_BASE_URL": "https://heed.run"
      }
    }
  }
}

Development

From the monorepo (install SDK first):

make install
HEED_API_KEY=hd_test_... HEED_BASE_URL=http://localhost:8000 venv/bin/heed-mcp

Install heed-mcp into its own virtualenv (or use uvx). Installing into the API venv can upgrade starlette past what the pinned FastAPI version supports.

Publish

./scripts/publish.sh

Requires build and twine, plus PyPI token in TWINE_PASSWORD.