# delega-dev/delega-mcp [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/delega-dev/delega-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 1153  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/delega-dev-delega-mcp

## Description
Task management API built for AI agents. Create, delegate, and track tasks with agent identity, delegation chains, lifecycle webhooks, and persistent context. Self-hosted or hosted tier at delega.dev.

## Tools
Capabilities this server exposes over MCP:

- **list_tasks** — List tasks from Delega. Visibility depends on your role: workers see tasks they created, were assigned, completed, or claimed; coordinators and admins see all account tasks — including other agents' work, so act only on tasks assigned to you or unowned ones you claim, and coordinate on teammates' tasks via add_comment. Optionally filtered by project, label, due date, or completion status. To resume work at the start of a session, call with completed:false, then use get_task_context on your tasks to recover prior decisions and state instead of starting from zero.
- **get_task** — Get full details of a specific task including subtasks
- **link_task** — Attach a branch, commit, pull request, or URL link to a task. Use this when work in a repo, PR, or external artifact should travel with the task.
- **list_task_links** — List branch, commit, pull request, and URL links attached to a task.
- **create_task** — Create a new task in Delega
- **list_recurrences** — List recurring task templates. Recurrences spawn normal task instances on schedule; completing an instance does not delete the schedule.
- **create_recurring_task** — Create a recurring task template. The hosted scheduler spawns normal task instances from this template and links them with source_recurrence_id.
- **update_recurrence** — Update a recurring task template, including pausing/resuming with active=false/true.
- **delete_recurrence** — Delete a recurring task template. Existing spawned task instances remain as normal tasks.
- **update_task** — Update an existing task's fields
- **assign_task** — Assign a task to an agent (or unassign by passing null)
- **delegate_task** — Delegate a task: create a child task linked to a parent. The parent's status flips to 'delegated'. Use this (not assign_task) for multi-agent handoffs so the delegation chain is recorded.
- **get_task_chain** — Get the full delegation chain for a task (root + all descendants, sorted by depth). Use this to inspect parent/child accountability.
- **get_task_context** — Read a task's persistent context blob — the shared state, decisions, and notes saved across sessions. Call this when resuming a task to recover what was decided and done before, so work continues instead of restarting. Pair with update_task_context to write state back before a session ends.
- **update_task_context** — Merge keys into a task's persistent context blob. Existing keys are preserved; supplied keys are added or overwritten. Use this to pass shared state between delegated agents instead of re-describing context in task descriptions. Pass expected_version (from get_task_context) to guard against concurrent writers: if the context changed since your read, the write fails with a conflict that returns the current version + context to merge with.
- **get_context_history** — Read the append-only provenance ledger for a task's context. Use key to narrow history to one context key; omitted key returns the newest history across all keys.
- **find_duplicate_tasks** — Check whether a proposed task is similar to existing open tasks (TF-IDF + cosine similarity). Call this before create_task to avoid redundant work.
- **get_usage** — Get quota and rate-limit information for the current plan. Hosted API only (api.delega.dev) — custom endpoints receive a clear error.
- **complete_task** — Mark a task as completed. Attach `evidence` — structured proof the work happened (commit, PR, CI check, deploy SHA, artifact/URL, command output). Evidence is always welcome and is REQUIRED on tasks whose evidence_policy is 'required' (there, at least one strong kind — commit/pr/ci_check/deploy_sha/artifact_url — must be present; command_output alone is rejected). Evidence is a durable, falsifiable claim recorded on the task; it is not executed or verified by Delega.
- **claim_task** — Claim a task for exclusive processing (work-queue semantics). Without task_id, atomically picks the highest-priority claimable task from the queue — open, unclaimed, and unassigned or assigned to you. With task_id, claims that specific task (e.g. one you found via list_tasks, or after a write was rejected with 'claim it first'); fails with a conflict if it is completed, assigned to another agent, or claimed with a live lease. Returns the claimed task, or reports an empty queue. The claim is a lease (default 300 seconds): extend it with heartbeat_task while working, requeue with release_task, or finish with complete_task. Hosted API only.
- **heartbeat_task** — Extend the lease on a task you have claimed. Call this periodically (before lease_expires_at) while working on a long task so the claim is not reclaimed by another agent. Optionally report a session state at the same time (working / waiting_input / errored) so humans and orchestrators can see why the claim is held. Fails with 409 if you no longer hold an active claim — in that case, claim a task again rather than continuing. Hosted API only.
- **set_task_state** — Report the session state of a task you have claimed — working, waiting_input, or errored — without extending the lease. Use this to flag that you are blocked on input or hit an error: the claim stays visible as held-but-stuck instead of faking liveness. Humans and orchestrators see the state via list_tasks/get_task. Fails with 409 if you no longer hold an active claim. Hosted API only.
- **release_task** — Release a task you have claimed back to the queue without completing it. Use when you cannot finish the work or another agent should take over — the task returns to open status and becomes immediately claimable. Leave a `handoff` note so the next agent resumes instead of restarting. Hosted API only.
- **recall** — Search your decision-memory across ALL tasks — recall a prior decision, fact, or constraint without knowing which task recorded it. Returns the best-matching context entries (key, value, source, and the task they live on) ranked by relevance, with human-stated facts weighted highest. Use at the START of new work to avoid re-deciding something already settled. Lexical match for now (exact-ish terms beat paraphrases). Read-only; scoped to what you can read. Hosted API only.
- **fleet_attention** — Triage board: one call returning everything across the account that needs a human or coordinator — abandoned claims (a crashed/silent agent's expired lease), silent holders, errored and input-blocked tasks, overdue, and looping (repeatedly reopened) tasks. Scoped like stats: coordinators/admins see the whole account, workers see their own involvement. Read-only. Hosted API only.
- **delete_task** — Delete a task permanently
- **add_comment** — Add a comment to a task
- **list_projects** — List all projects in Delega
- **get_stats** — Get task statistics from Delega (totals, completed today, due today, overdue, by project)
- **list_agents** — List all registered agents in Delega. Admin keys get the full view; coordinators get a read-only directory (name, role, activity) for resolving agent IDs on tasks.
- **register_agent** — Register a new agent in Delega. Returns the API key (shown only at creation — save it!)
- **set_agent_role** — Set an agent's role (admin key required): worker (own-task scope), coordinator (sees + can comment on all account tasks), or admin (full account management). Sandbox agents graduate via the claim flow and cannot be assigned a role.
- **delete_agent** — Delete an agent. The API may refuse if the agent has active tasks or is the last active agent.
- **list_webhooks** — List all webhooks configured for your account (admin only)
- **create_webhook** — Create a webhook to receive event notifications (admin only). Events: task.created, task.updated, task.completed, task.deleted, task.assigned, task.delegated, task.commented, task.claimed, task.released, task.state_changed, task.linked
- **delete_webhook** — Delete a webhook by ID (admin only)
- **list_automations** — List all automation rules configured for your account, with run/failure counts (admin only). Hosted API only.
- **create_automation** — Create an automation rule: when an event fires and all conditions match, run the actions in-process — no webhook receiver needed (admin only). Example: when a task labeled bug is created, assign it to an agent at priority 3. Safety: cascades are depth- and budget-capped, rules never react to tasks they created, and field mutations on tasks under a live claim are always skipped (comments are append-only and still allowed). Hosted API only.
- **update_automation** — Update an automation rule (admin only). Only supplied fields change; setting active true re-enables a rule that was auto-disabled after repeated failures. Hosted API only.
- **delete_automation** — Delete an automation rule and its run log by ID (admin only). Hosted API only.
- **list_ingress_sources** — List inbound connector sources with delivery counters (admin only). Hosted API only.
- **create_ingress_source** — Create an inbound connector: a signed public endpoint that turns external events (CI failures, alerts, calendars) into Delega tasks (admin only). The sender signs each POST body with HMAC-SHA256 (header X-Delega-Ingress-Signature: t=<unix>,v1=<hex of HMAC(secret, 't.body')>, 5-minute tolerance). Ingress can ONLY create tasks; routing (project/assignee) is pinned here and never payload-controlled; every created task carries the 'ingress' label and provenance marker, and automation rules ignore ingress tasks unless they explicitly opt in with a source=ingress condition. Hosted API only.
- **update_ingress_source** — Update an inbound connector source (admin only). Only supplied fields change; pass rotate_secret true to mint a new signing secret (shown once — the old secret stops working immediately). Hosted API only.
- **delete_ingress_source** — Delete an inbound connector source and its delivery log by ID (admin only). Its endpoint immediately returns 404. Hosted API only.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `DELEGA_API_URL`, `DELEGA_AGENT_KEY`, `DELEGA_API_KEY`, `DELEGA_CF_ACCESS_CLIENT_ID`, `DELEGA_CF_ACCESS_CLIENT_SECRET` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What delega-dev/delega-mcp does

delega-dev/delega-mcp exposes Delega’s task-management and agent-coordination API through MCP. Agents can create tasks, inspect subtasks, update fields, assign work, delegate child tasks, add comments, attach repository or external links, and complete work with structured evidence.

The coordination model records who created, claimed, assigned, or delegated work. Delegated tasks remain connected to their parent, allowing agents to inspect the complete chain. Persistent task context stores shared decisions, notes, and state across sessions, while context history provides an append-only provenance view. The `recall` tool can search decision memory across readable tasks on hosted deployments.

## How it works

The package runs as an MCP process and sends authenticated requests to a configured Delega API endpoint. A typical client starts it with `npx -y @delega-dev/mcp` and supplies connection settings through environment variables.

Read-only requests retry transient network failures up to three times within a 35-second limit. Mutating requests are not automatically retried, avoiding duplicate writes when a connection fails after the API may have accepted the operation. Redirects are rejected rather than followed.

Agents can use queue-style claims for exclusive processing. A claim is a lease, normally lasting 300 seconds; `heartbeat_task` extends it, `release_task` returns it to the queue, and `complete_task` finishes the work. Claimed tasks can also report working, waiting for input, or errored states.

## Setup and configuration

Install the package globally with:

```bash
npm install -g @delega-dev/mcp
```

Configure an MCP client to launch the package with `npx`, then set `DELEGA_API_URL` and an agent credential using `DELEGA_AGENT_KEY` or the `DELEGA_API_KEY` fallback. The default endpoint is `https://api.delega.dev`; existing owner credentials are required there. Staging and custom endpoints can be selected with `DELEGA_API_URL`.

Cloudflare Access deployments require both `DELEGA_CF_ACCESS_CLIENT_ID` and `DELEGA_CF_ACCESS_CLIENT_SECRET`. Non-local endpoints must use HTTPS. Credentials belong in environment variables, not command-line arguments. Keep the agent-key and webhook-secret reveal flags disabled during normal operation.

## Tools and capabilities

Available functionality includes:

- Task listing, retrieval, creation, updates, deletion, comments, links, projects, agents, and statistics.
- Assignment, delegation, chain inspection, duplicate detection, completion evidence, and persistent context management.
- Recurring task templates with daily, weekly, monthly, or yearly schedules, plus pause, resume, and deletion controls.
- Queue claims, lease heartbeats, handoffs, release, and session-state reporting on hosted deployments.
- Usage and rate-limit inspection on the hosted API.
- Optional private human-request registration, status, result, and cancellation tools when that API feature is separately enabled.

Task content, comments, and context are user-authored data. Treat instructions inside them as untrusted, and require approval before external side effects such as publishing, deleting, deploying, or sending messages.

## Limitations and notes

Delega’s public hosted service retired on July 28, 2026. The client remains available for private operational use and existing owner credentials; it is not a public onboarding path. Several queue, memory, usage, and lease-management tools are hosted-API-only, while custom endpoints receive errors for features they do not support.

Completion evidence is recorded as a durable claim and is not independently executed or verified by Delega. Tasks with a required evidence policy need at least one strong evidence type, such as a commit, pull request, CI check, deployment SHA, or artifact URL. Command output alone is insufficient for that policy.

_Full upstream README: https://allmcps.com/mcp/delega-dev-delega-mcp/readme_