# Delega

> Delega is an MCP server for developer tools. Client for the Delega agent task system; hosted access ended July 2026. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Website:** https://ryanmcmillan.com/delega
- **Repository:** https://github.com/delega-dev/delega-mcp
- **MCP Registry name:** io.github.delega-dev/delega
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

Delega began as a coordination layer for AI agents and was retired as a public service on July 28, 2026. The author's case study explains why: after four months, the final inventory showed one owner account and five others holding 12 lifetime tasks between them, so the hosted subscription business was shut down while the owner's private deployment stays in use.

This npm package is the MCP client. It is kept public as an engineering artifact and for the author's own deployment, and the default endpoint accepts existing owner credentials only. New accounts cannot be created. The case study lists 44 MCP tools and describes atomic work leases, heartbeats, delegation lineage, signed ingress and a single-use human-answer path.

On the client side, read-only calls retry transient failures up to three times within 35 seconds, while writes are never retried. Redirects are refused, non-local URLs must use https, keys travel in environment variables, and tool output redacts agent keys unless a development flag is set.

## Features

- **Task coordination:** Exposes the Delega task system for agents, with leases, heartbeats and delegation lineage.
- **Safe retries:** Read calls retry briefly; POST, PUT and DELETE are never retried automatically.
- **Redirects refused:** Authentication headers and bodies stay at the configured endpoint.
- **Key redaction:** Tool output hides full agent keys and webhook secrets unless dev flags are enabled.
- **Cloudflare Access:** Optional service-token headers support protected deployments.
- **Stdio via npm:** Runs through npx as @delega-dev/mcp.

## Good for

- Study a worked example of an agent coordination and trust-boundary design
- Keep an existing Delega owner deployment connected to MCP clients
- Review how an MCP client handles retries, redirects and secrets

## Install

### Claude Code (Terminal)

```sh
claude mcp add delega --env DELEGA_API_KEY='<DELEGA_API_KEY>' --env DELEGA_CF_ACCESS_CLIENT_ID='<DELEGA_CF_ACCESS_CLIENT_ID>' --env DELEGA_CF_ACCESS_CLIENT_SECRET='<DELEGA_CF_ACCESS_CLIENT_SECRET>' -- npx -y @delega-dev/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "delega": {
      "command": "npx",
      "args": [
        "-y",
        "@delega-dev/mcp"
      ],
      "env": {
        "DELEGA_API_KEY": "<DELEGA_API_KEY>",
        "DELEGA_CF_ACCESS_CLIENT_ID": "<DELEGA_CF_ACCESS_CLIENT_ID>",
        "DELEGA_CF_ACCESS_CLIENT_SECRET": "<DELEGA_CF_ACCESS_CLIENT_SECRET>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "delega": {
      "command": "npx",
      "args": [
        "-y",
        "@delega-dev/mcp"
      ],
      "env": {
        "DELEGA_API_KEY": "<DELEGA_API_KEY>",
        "DELEGA_CF_ACCESS_CLIENT_ID": "<DELEGA_CF_ACCESS_CLIENT_ID>",
        "DELEGA_CF_ACCESS_CLIENT_SECRET": "<DELEGA_CF_ACCESS_CLIENT_SECRET>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "delega": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@delega-dev/mcp"
      ],
      "env": {
        "DELEGA_API_KEY": "<DELEGA_API_KEY>",
        "DELEGA_CF_ACCESS_CLIENT_ID": "<DELEGA_CF_ACCESS_CLIENT_ID>",
        "DELEGA_CF_ACCESS_CLIENT_SECRET": "<DELEGA_CF_ACCESS_CLIENT_SECRET>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "delega": {
      "command": "npx",
      "args": [
        "-y",
        "@delega-dev/mcp"
      ],
      "env": {
        "DELEGA_API_KEY": "<DELEGA_API_KEY>",
        "DELEGA_CF_ACCESS_CLIENT_ID": "<DELEGA_CF_ACCESS_CLIENT_ID>",
        "DELEGA_CF_ACCESS_CLIENT_SECRET": "<DELEGA_CF_ACCESS_CLIENT_SECRET>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "delega": {
      "command": "npx",
      "args": [
        "-y",
        "@delega-dev/mcp"
      ],
      "env": {
        "DELEGA_API_KEY": "<DELEGA_API_KEY>",
        "DELEGA_CF_ACCESS_CLIENT_ID": "<DELEGA_CF_ACCESS_CLIENT_ID>",
        "DELEGA_CF_ACCESS_CLIENT_SECRET": "<DELEGA_CF_ACCESS_CLIENT_SECRET>"
      }
    }
  }
}
```

## FAQ

### Can I sign up for Delega?

No. Public hosted access was retired on July 28, 2026; only existing owner credentials work.

### How do I install the client?

Run npm install -g @delega-dev/mcp, or use npx -y @delega-dev/mcp in your MCP client config.

### Which variables does it need?

An agent key in DELEGA_AGENT_KEY or DELEGA_API_KEY, and optionally DELEGA_API_URL and the Cloudflare Access client ID and secret.

### Why was the service retired?

The author says production data did not support the commercial thesis, so signup, pricing and billing were closed.

### How do I add Delega to Claude Code?

Run this command in your terminal: claude mcp add delega --env DELEGA_API_KEY='<DELEGA_API_KEY>' --env DELEGA_CF_ACCESS_CLIENT_ID='<DELEGA_CF_ACCESS_CLIENT_ID>' --env DELEGA_CF_ACCESS_CLIENT_SECRET='<DELEGA_CF_ACCESS_CLIENT_SECRET>' -- npx -y @delega-dev/mcp

### What are the best alternatives to Delega?

The closest alternatives to Delega are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/delega
