MCP Task Orchestrator
MCP Task Orchestrator is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Workflow discipline for AI agents: work items, gates, role-scoped tool… It has 214 GitHub stars, is released under the MIT license and runs locally with docker run -i --rm -e API_ALLOW_QUERY_TOKEN_FOR_SSE -e API_AUTH_MODE -e API_JWKS_MAX_TOKEN_LIFETIME_SECONDS ghcr.io/jpicklyk/task-orchestrator:4.0.2.
github.com/jpicklyk/task-orchestrator (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
- Needs API key
- Developer tools
- MIT
- Active
Install MCP Task Orchestrator
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"mcp-task-orchestrator": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"API_ALLOW_QUERY_TOKEN_FOR_SSE",
"-e",
"API_AUTH_MODE",
"-e",
"API_JWKS_MAX_TOKEN_LIFETIME_SECONDS",
"ghcr.io/jpicklyk/task-orchestrator:4.0.2"
],
"env": {
"API_ALLOW_QUERY_TOKEN_FOR_SSE": "your-value",
"API_AUTH_MODE": "your-value",
"API_JWKS_MAX_TOKEN_LIFETIME_SECONDS": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env API_ALLOW_QUERY_TOKEN_FOR_SSE=your-value --env API_AUTH_MODE=your-value --env API_JWKS_MAX_TOKEN_LIFETIME_SECONDS=your-value --transport stdio mcp-task-orchestrator -- docker run -i --rm -e API_ALLOW_QUERY_TOKEN_FOR_SSE -e API_AUTH_MODE -e API_JWKS_MAX_TOKEN_LIFETIME_SECONDS ghcr.io/jpicklyk/task-orchestrator:4.0.2Cursor
{
"mcpServers": {
"mcp-task-orchestrator": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"API_ALLOW_QUERY_TOKEN_FOR_SSE",
"-e",
"API_AUTH_MODE",
"-e",
"API_JWKS_MAX_TOKEN_LIFETIME_SECONDS",
"ghcr.io/jpicklyk/task-orchestrator:4.0.2"
],
"env": {
"API_ALLOW_QUERY_TOKEN_FOR_SSE": "your-value",
"API_AUTH_MODE": "your-value",
"API_JWKS_MAX_TOKEN_LIFETIME_SECONDS": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "api_allow_query_token_for_sse",
"description": "API_ALLOW_QUERY_TOKEN_FOR_SSE",
"password": true
},
{
"type": "promptString",
"id": "api_auth_mode",
"description": "API_AUTH_MODE",
"password": true
},
{
"type": "promptString",
"id": "api_jwks_max_token_lifetime_seconds",
"description": "API_JWKS_MAX_TOKEN_LIFETIME_SECONDS",
"password": true
}
],
"servers": {
"mcp-task-orchestrator": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"API_ALLOW_QUERY_TOKEN_FOR_SSE",
"-e",
"API_AUTH_MODE",
"-e",
"API_JWKS_MAX_TOKEN_LIFETIME_SECONDS",
"ghcr.io/jpicklyk/task-orchestrator:4.0.2"
],
"env": {
"API_ALLOW_QUERY_TOKEN_FOR_SSE": "${input:api_allow_query_token_for_sse}",
"API_AUTH_MODE": "${input:api_auth_mode}",
"API_JWKS_MAX_TOKEN_LIFETIME_SECONDS": "${input:api_jwks_max_token_lifetime_seconds}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
DATABASE_PATH | No | SQLite database file path (default: data/current-tasks.db) |
AGENT_CONFIG_DIR | No | Directory containing .taskorchestrator/config.yaml for workflow schemas (default: working dir) |
MCP_TRANSPORT | No | Transport mode: stdio (default) or http |
MCP_HTTP_PORT | No | HTTP port when using http transport (default: 3001) |
MCP_SESSION_IDLE_TIMEOUT_MINUTES | No | Minutes without a request before an HTTP MCP session is closed; the client re-initializes on its next call (default: 120) |
LOG_LEVEL | No | Logging level: DEBUG, INFO, WARN, ERROR (default: INFO) |
LOG_FILE | No | Optional log file path. Unset (default) disables file logging; logs are always JSON on stderr. |
API_ALLOW_QUERY_TOKEN_FOR_SSEsecret | No | Allow ?token= auth for SSE (browser EventSource workaround) (default: false) |
API_ALLOW_UNAUTHENTICATED | No | Confirm flag required alongside APIAUTHMODE=none (default: false) |
API_AUTH_MODEsecret | No | REST API auth mode: bearer, jwks, or none (with APIALLOWUNAUTHENTICATED=true). Required when API_ENABLED=true |
API_ENABLED | No | Master REST API switch; set true to register /api/v1/* routes (default: false) |
API_JWKS_ALGORITHMS | No | Comma-separated JWT algorithm allowlist for jwks mode (e.g. RS256,EdDSA) |
API_JWKS_ALLOW_INSECURE_URL | No | Loopback-only opt-in to fetch APIJWKSURL over plaintext http (default: false) |
API_JWKS_AUDIENCE | No | Expected aud claim value in JWTs (jwks mode) |
API_JWKS_CACHE_TTL_SECONDS | No | JWKS key cache TTL in seconds (default: 300) |
API_JWKS_ISSUER | No | Expected iss claim value in JWTs (jwks mode) |
API_JWKS_MAX_STALE_SECONDS | No | Oldest a cached key set may be and still be served after a failed refresh (default: max(3600, TTL)) |
API_JWKS_MAX_TOKEN_LIFETIME_SECONDSsecret | No | Maximum accepted token lifetime in seconds (default: 86400) |
API_JWKS_URL | No | JWKS endpoint URL (jwks mode); must be https and resolve to public addresses |
API_REDACT_NOTE_ATTRIBUTION | No | Redact actor/verification on notes for non-admin callers (default: true) |
About MCP Task Orchestrator
Server-enforced workflow discipline for AI agents. Prompt-based frameworks hope the LLM follows instructions. This one blocks the call if it doesn't.
- ai-coding-assistant
- ai-development
- ai-memory
- ai-tools
- claude
- claude-code
- claude-desktop
- context-persistence
- developer-tools
- mcp
Similar MCP servers
More developer tools MCP servers
MCP Abap Abap Adt API
mario-andreschak/mcp-abap-abap-adt-api
MCP server wrapping abap-adt-api for ABAP ADT development workflows against SAP systems.
Maintained · last commit Sep 16, 2026
Developer toolsTypeScriptBitbybit CAD MCP
bitbybit-dev/bitbybit
Bitbybit 3D parametric CAD API, version-exact, for coding agents: search, describe, examples, guide.
Active · last commit Nov 13, 2026
OfficialDeveloper toolsTypeScriptGlif
glifxyz/glif-mcp-server
Generate images, video, and audio with Glif's media-generation agent.
Maintained · last commit Oct 8, 2026
OfficialDeveloper toolsJavaScriptMCP Abap Adt
mario-andreschak/mcp-abap-adt
ABAP ADT MCP server for reading SAP objects (programs, classes, tables, CDS) via ADT.
Maintained · last commit Oct 25, 2026
Developer toolsTypeScriptChiasmus
yogthos/chiasmus
Chiasmus is an MCP server that gives language models access to formal verification.
Maintained · last commit Oct 18, 2026
Developer toolsTypeScriptOpenVibeCoding Read-only MCP
xiaojiou176-open/codeflow
Read-only MCP for OpenVibeCoding runs, workflows, proof, queue, replay, and incident reads.
Maintained · last commit May 27, 2026
Developer toolsPython
How do I install the MCP Task Orchestrator MCP server?
Add the command docker run -i --rm -e API_ALLOW_QUERY_TOKEN_FOR_SSE -e API_AUTH_MODE -e API_JWKS_MAX_TOKEN_LIFETIME_SECONDS ghcr.io/jpicklyk/task-orchestrator:4.0.2 to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is MCP Task Orchestrator free?
The server is open source under the MIT license, so running it is free. It needs credentials (API_ALLOW_QUERY_TOKEN_FOR_SSE, API_AUTH_MODE and API_JWKS_MAX_TOKEN_LIFETIME_SECONDS) for the service it connects to, which may require a paid account.
Is MCP Task Orchestrator actively maintained?
The most recent commit was on Nov 16, 2026. The latest release is v4.0.2, published Nov 11, 2026. appsgit only lists MCP servers with a commit in the last six months.