{"id":47240683,"url":"https://github.com/delega-dev/delega-mcp","last_synced_at":"2026-06-12T05:00:51.301Z","repository":{"id":343740211,"uuid":"1178918480","full_name":"delega-dev/delega-mcp","owner":"delega-dev","description":"MCP server for Delega — connect any MCP client to your task API","archived":false,"fork":false,"pushed_at":"2026-06-10T04:55:36.000Z","size":153,"stargazers_count":0,"open_issues_count":6,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-10T05:05:20.717Z","etag":null,"topics":["ai-agents","delega","delegation","mcp","mcp-server","model-context-protocol","task-management"],"latest_commit_sha":null,"homepage":"https://delega.dev","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/delega-dev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-11T13:57:54.000Z","updated_at":"2026-06-10T04:53:21.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/delega-dev/delega-mcp","commit_stats":null,"previous_names":["delega-dev/delega-mcp"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/delega-dev/delega-mcp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delega-dev%2Fdelega-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delega-dev%2Fdelega-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delega-dev%2Fdelega-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delega-dev%2Fdelega-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/delega-dev","download_url":"https://codeload.github.com/delega-dev/delega-mcp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/delega-dev%2Fdelega-mcp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34165751,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-10T02:00:07.152Z","response_time":89,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","delega","delegation","mcp","mcp-server","model-context-protocol","task-management"],"created_at":"2026-03-14T02:27:24.393Z","updated_at":"2026-06-12T05:00:51.293Z","avatar_url":"https://github.com/delega-dev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# delega-mcp\n\nMCP server for [Delega](https://delega.dev) — the task handoff layer for AI agents.\n\nConnect any MCP-compatible client (Claude Code, Cursor, Codex, etc.) to Delega and manage tasks, projects, and agents through natural language.\n\n## Install\n\n```bash\nnpm install -g @delega-dev/mcp\n```\n\n## Configure\n\nAdd to your MCP client config (e.g. Claude Code `claude_code_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"delega\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@delega-dev/mcp\"],\n      \"env\": {\n        \"DELEGA_API_URL\": \"https://api.delega.dev\",\n        \"DELEGA_AGENT_KEY\": \"dlg_your_agent_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `DELEGA_API_URL` | `https://api.delega.dev` | Delega API endpoint. Defaults to the hosted API; custom `/api`-style endpoints (e.g. `http://localhost:18890`) are an advanced override. |\n| `DELEGA_AGENT_KEY` | (none) | Agent API key for authenticated requests |\n| `DELEGA_REVEAL_AGENT_KEYS` | `0` | **⚠️ Development only.** Set to `1` to print full API keys in tool output. Never enable in production: a prompt-injected agent could exfiltrate keys from `create_agent` or `list_agents` responses. |\n\nUse `https://api.delega.dev` as the URL.\n\n## Security Notes\n\n- Non-local `DELEGA_API_URL` values must use `https://`.\n- Agent keys are passed through environment variables rather than command-line arguments, which avoids process-list leakage.\n- MCP tool output redacts full agent API keys by default.\n- **Do not set `DELEGA_REVEAL_AGENT_KEYS=1` in production.** This flag exists for initial setup only. In production, a prompt-injected agent could exfiltrate keys from `create_agent` or `list_agents` tool output. Keys are returned once at creation time; use `rotate_agent_key` if you need a new one.\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `list_tasks` | List tasks, filter by project, label, due date, completion |\n| `get_task` | Get full task details including subtasks and task links |\n| `link_task` | Attach a branch, commit, PR, or URL link to a task |\n| `list_task_links` | List branch, commit, PR, and URL links attached to a task |\n| `create_task` | Create a new task |\n| `update_task` | Update task fields (incl. `assigned_to_agent_id`) |\n| `assign_task` | Assign a task to an agent (or pass `null` to unassign) |\n| `delegate_task` | Delegate a task: create a child task linked to a parent (parent status flips to `delegated`). Use this for multi-agent handoffs — `assign_task` does not create a delegation chain. |\n| `get_task_chain` | Return the full delegation chain for a task (root + descendants, sorted by depth) |\n| `update_task_context` | Merge keys into a task's persistent context blob (deep merge, not replace), recording provenance source |\n| `get_task_context` | Read a task's persistent context blob, optionally with per-key provenance |\n| `get_context_history` | Read the append-only provenance ledger for a task's context |\n| `find_duplicate_tasks` | Check whether proposed task content is similar to existing open tasks (TF-IDF + cosine similarity). Call before `create_task` to avoid redundant work. |\n| `get_usage` | Return quota + rate-limit info. **Hosted API only** (`api.delega.dev`); custom endpoints receive a clear error. |\n| `claim_task` | Claim the next available task from the queue for exclusive processing (work-queue semantics). Lease-based: default 300s, configurable 30-3600. Returns the task or reports an empty queue. **Hosted API only.** |\n| `heartbeat_task` | Extend the lease on a claimed task. Call periodically while working so the claim isn't reclaimed. **Hosted API only.** |\n| `release_task` | Release a claimed task back to the queue without completing it. **Hosted API only.** |\n| `set_task_state` | Report `working`, `waiting_input`, or `errored` on a claimed task without extending the lease. **Hosted API only.** |\n| `complete_task` | Mark a task as completed |\n| `delete_task` | Delete a task permanently |\n| `add_comment` | Add a comment to a task |\n| `list_projects` | List all projects |\n| `get_stats` | Get task statistics |\n| `list_agents` | List registered agents |\n| `register_agent` | Register a new agent (returns API key), optionally with a role preset |\n| `set_agent_role` | Set an agent's role: `worker`, `coordinator`, or `admin` (admin key required) |\n| `delete_agent` | Delete an agent (refused if agent has active tasks) |\n| `list_webhooks` | List all webhooks (admin only) |\n| `create_webhook` | Create a webhook for event notifications, including `task.linked` (admin only) |\n| `delete_webhook` | Delete a webhook by ID (admin only) |\n\n### Task output format\n\nTask-returning tools (`list_tasks`, `get_task`, `create_task`, `update_task`, `assign_task`) render each task with assignment metadata when available:\n\n```\n[#42] Ship the release\n  Description: Cut RC, tag, push to npm\n  Project: Delega\n  Labels: release\n  Priority: 3\n  Due: 2026-04-20\n  Assigned to: Coordinator (#7)\n  Created by: planner (#3)\n  Completed: no\n```\n\n`Assigned to` / `Created by` / `Completed by` lines are emitted only when the underlying field is populated. Custom `/api`-style endpoints return a nested agent object so the assignee renders as `\u003cdisplay_name\u003e (#id)`; the hosted `api.delega.dev` API returns the raw agent ID so it renders as `#\u003cid\u003e`.\n\nTasks that are part of a delegation chain also surface the chain metadata:\n\n```\n[#def] Draft intro\n  Status: delegated\n  Assigned to: Drafter (#3)\n  Created by: Coordinator (#7)\n  Delegation: depth 1, parent #abc, root #abc\n  Delegated by: Coordinator (#7)\n  Completed: no\n  Context keys: step, findings (2)\n```\n\nSingle-task tools (`get_task`, `create_task`, `update_task`, `assign_task`, `delegate_task`, `update_task_context`) use a detail render that pretty-prints the full `context` blob (truncated at 2000 chars). `list_tasks` uses the concise list render which shows `Context keys: …` instead.\n\n`get_task` also shows attached task links when present:\n\n```\n  Links:\n    branch: delega-dev/delega-api phase-3-github — https://github.com/delega-dev/delega-api/tree/phase-3-github\n    pr: delega-dev/delega-api 42 — https://github.com/delega-dev/delega-api/pull/42\n```\n\n### Delegation chains\n\n`get_task_chain` returns the full parent/child chain for any task in the chain. Output is indented by `delegation_depth`:\n\n```\nDelegation chain (root #abc, depth 2, 2/4 complete):\n  [#abc] Write report (depth 0, delegated)\n    [#def] Draft intro (depth 1, completed)\n    [#jkl] Draft conclusion (depth 1, pending)\n      [#ghi] Research sources (depth 2, completed)\n```\n\nNodes are sorted by depth then creation order (matching the API's response ordering).\n\n## Hosted API\n\nDelega is a hosted service. Point `DELEGA_API_URL` at `https://api.delega.dev` — free up to 1,000 tasks/month.\n\n## Links\n\n- [Delega](https://delega.dev) — Main site\n- [GitHub](https://github.com/delega-dev/delega-mcp) — Source code\n- [API Docs](https://delega.dev/docs) — REST API reference\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelega-dev%2Fdelega-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdelega-dev%2Fdelega-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdelega-dev%2Fdelega-mcp/lists"}