Skip to content
appsgit

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

Install MCP Task Orchestrator

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "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.2

Cursor

.cursor/mcp.json
{
  "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

.vscode/mcp.json
{
  "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.

NameRequiredDescription
DATABASE_PATHNoSQLite database file path (default: data/current-tasks.db)
AGENT_CONFIG_DIRNoDirectory containing .taskorchestrator/config.yaml for workflow schemas (default: working dir)
MCP_TRANSPORTNoTransport mode: stdio (default) or http
MCP_HTTP_PORTNoHTTP port when using http transport (default: 3001)
MCP_SESSION_IDLE_TIMEOUT_MINUTESNoMinutes without a request before an HTTP MCP session is closed; the client re-initializes on its next call (default: 120)
LOG_LEVELNoLogging level: DEBUG, INFO, WARN, ERROR (default: INFO)
LOG_FILENoOptional log file path. Unset (default) disables file logging; logs are always JSON on stderr.
API_ALLOW_QUERY_TOKEN_FOR_SSEsecretNoAllow ?token= auth for SSE (browser EventSource workaround) (default: false)
API_ALLOW_UNAUTHENTICATEDNoConfirm flag required alongside APIAUTHMODE=none (default: false)
API_AUTH_MODEsecretNoREST API auth mode: bearer, jwks, or none (with APIALLOWUNAUTHENTICATED=true). Required when API_ENABLED=true
API_ENABLEDNoMaster REST API switch; set true to register /api/v1/* routes (default: false)
API_JWKS_ALGORITHMSNoComma-separated JWT algorithm allowlist for jwks mode (e.g. RS256,EdDSA)
API_JWKS_ALLOW_INSECURE_URLNoLoopback-only opt-in to fetch APIJWKSURL over plaintext http (default: false)
API_JWKS_AUDIENCENoExpected aud claim value in JWTs (jwks mode)
API_JWKS_CACHE_TTL_SECONDSNoJWKS key cache TTL in seconds (default: 300)
API_JWKS_ISSUERNoExpected iss claim value in JWTs (jwks mode)
API_JWKS_MAX_STALE_SECONDSNoOldest a cached key set may be and still be served after a failed refresh (default: max(3600, TTL))
API_JWKS_MAX_TOKEN_LIFETIME_SECONDSsecretNoMaximum accepted token lifetime in seconds (default: 86400)
API_JWKS_URLNoJWKS endpoint URL (jwks mode); must be https and resolve to public addresses
API_REDACT_NOTE_ATTRIBUTIONNoRedact 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

FAQ

MCP Task Orchestrator FAQ

Still curious? Email info@appsgit.com.

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.