INDIVIDUAL MCP TOOL

upsertPlanTask

Create or update a DRAFT task in a doc — a proposal, not a board task (it only becomes real when a human approves the plan).

perkos.xyznone authenticationAvailability not checked

LIVE ENDPOINT

https://mcp.perkos.xyz/mcp

No auth detected

Connect to this endpoint to inspect the live schema for upsertPlanTask and invoke it with your own arguments.

{}

Potential side effects detected · medium confidence · heuristic, not a guarantee.

CONNECT WITH APPROVAL

Review this server and its permissions before adding it. Secret placeholders must be set locally.

Codex

~/.codex/config.toml

[mcp_servers.perkos]
url = "https://mcp.perkos.xyz/mcp"
enabled = true

Claude Code

.mcp.json

{
  "mcpServers": {
    "perkos": {
      "type": "http",
      "url": "https://mcp.perkos.xyz/mcp"
    }
  }
}

Claude Desktop

Settings → Connectors → Add custom connector

Name: perkos
Remote MCP URL: https://mcp.perkos.xyz/mcp

Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.

Cursor

.cursor/mcp.json

{
  "mcpServers": {
    "perkos": {
      "url": "https://mcp.perkos.xyz/mcp"
    }
  }
}

Visual Studio Code

.vscode/mcp.json

Add to Visual Studio Code

{
  "servers": {
    "perkos": {
      "type": "http",
      "url": "https://mcp.perkos.xyz/mcp"
    }
  }
}

Generic MCP

Client-specific MCP configuration

{
  "name": "perkos",
  "transport": "streamable-http",
  "url": "https://mcp.perkos.xyz/mcp"
}

MCP Inspector

Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.

createTask — Create a task on a project's job board and optionally assign it to a worker agent by name.
updateTaskStatus — Move a task to a new column and optionally record its result.
listProjectTasks — List the tasks on a project's job board (id, name, status, assigned agent, prompt, result).
postProjectMessage — Post a message to the project chat / team (e.g.
listDocs — List a project's docs (the docs workspace tree): each doc's id, type (note|plan|spec), title, status, draft flag, parentId.
createDoc — Create a new doc in the project's docs workspace (type: note | plan | spec).
readDoc — Read a project doc + its blocks in order (note blocks written by humans, plus planGroup/planTask blocks).
upsertPlanGroup — Create or update a task group (sprint section) in a doc.