From 60b977f402962976ee8f7ccfba6508f43f04ecb0 Mon Sep 17 00:00:00 2001 From: johnxie Date: Thu, 17 Sep 2026 02:42:12 -0700 Subject: [PATCH 1/3] docs: Rewrite README as hosted-MCP-first Reorders the 'Which MCP' table: hosted /mcp first, stdio npm as offline fallback. Fixes tier claim (Starter+, not Business+). Adds 'Add to Cursor' config block at the top. Clarifies 62 vs 32 tool count. Updates privacy section to list v2 as primary. The 164-star mcp repo is the developer brand. The old README sent Cursor users to the v1 stdio wrapper (no write_file, no inspect_space) and called the hosted server a separate product. This fixes the single biggest developer-surface confusion. Co-authored-by: Cursor --- README.md | 34 ++++++++++++++++++++++++++++------ 1 file changed, 28 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index 6173a30..0ee71f4 100644 --- a/README.md +++ b/README.md @@ -22,6 +22,26 @@ --- +## Quick Start (Hosted MCP) + +Get your token at [taskade.com/settings/api](https://www.taskade.com/settings/api), then paste this into your client's MCP config: + +```json +{ + "mcpServers": { + "taskade": { + "type": "http", + "url": "https://www.taskade.com/mcp", + "headers": { + "Authorization": "Bearer " + } + } + } +} +``` + +--- + ## Contents - [Demo](#demo) @@ -58,13 +78,13 @@ MCP-powered Taskade agent running inside Claude Desktop by Anthropic: ## Which Taskade MCP do I want? -Taskade speaks MCP through three surfaces — this repo is the first one: +Taskade speaks MCP through three surfaces - the hosted server is the primary one: -| I want to… | Use | Where / auth | +| I want to... | Use | Where / auth | |---|---|---| -| Have my AI client **read & write tasks** (complete, assignees, dates) plus projects and agents | **Workspace MCP** — this repo (`@taskade/mcp-server`) | Local stdio · personal token · any plan | -| **Connect remotely** — browse the workspace, create projects, prompt agents, edit Genesis `app/` source | **[Hosted Taskade MCP](https://github.com/taskade/docs/blob/main/apis-living-system-development/genesis-app-mcp.md)** | `https://www.taskade.com/mcp` · OAuth 2.0 (PKCE) · every paid plan | -| Let my agents **reach Slack / Shopify / Gmail** | **[MCP Connectors](https://github.com/taskade/docs/blob/main/genesis-living-system-builder/genesis/mcp-connectors.md)** | Hosted, in-product | +| **Read & write my workspace** (projects, tasks, agents, app files) | **Hosted MCP** at `https://www.taskade.com/mcp` | Hosted HTTP · personal token · Starter+ | +| Run MCP **locally / offline** (v1 surface, no app file editing) | **Stdio npm** `@taskade/mcp-server` (this repo) | Local stdio · personal token · most plans | +| Let my agents reach Slack / Shopify / Gmail | **[MCP Connectors](https://github.com/taskade/docs/blob/main/genesis-living-system-builder/genesis/mcp-connectors.md)** | Hosted, in-product | ### 1. Get Your API Key @@ -197,6 +217,8 @@ Hosted tools cover workspace browse (`list_spaces`, `inspect_space`), project/ag ## Tools (62) +> **Tool count tracks the hosted server.** The hosted MCP at `/mcp` currently exposes 32 tools (28 Public API v2 ops + 4 MCP-native: `inspect_space`, `write_file`, `read_project`, `list_automations`). The stdio npm package in this repo wraps the v1 API and exposes 14 ops. For the full workspace surface including app-file editing, use the hosted URL above. + ### Workspaces | Tool | Description | @@ -551,7 +573,7 @@ See [open issues](https://github.com/taskade/mcp/issues) for planned features an ## Privacy & Security -Your Taskade API token authorizes the MCP server to call the Taskade public API on your behalf. The server talks **only** to the Taskade public API — `https://www.taskade.com/api/v1` and `https://www.taskade.com/api/v2` — and does not send your data to other third-party services. +Your Taskade API token authorizes the MCP server to call the Taskade public API on your behalf. The server talks **only** to the Taskade public API — `https://www.taskade.com/api/v2` (primary) and `https://www.taskade.com/api/v1` (legacy task CRUD) — and does not send your data to other third-party services. - **Privacy** — see the [Taskade Privacy Policy](https://www.taskade.com/privacy). - **Security & vulnerability reporting** — see [SECURITY.md](./SECURITY.md). From c469660625a6513496886f10f7fabaa5e7a9f632 Mon Sep 17 00:00:00 2001 From: johnxie Date: Thu, 17 Sep 2026 03:00:49 -0700 Subject: [PATCH 2/3] fix(docs): Replace offline with stdio in MCP comparison table Aligns with Copilot review on taskcade#29493: the stdio npm package makes network requests and is not offline-capable. Co-authored-by: Cursor --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 0ee71f4..51ec554 100644 --- a/README.md +++ b/README.md @@ -83,7 +83,7 @@ Taskade speaks MCP through three surfaces - the hosted server is the primary one | I want to... | Use | Where / auth | |---|---|---| | **Read & write my workspace** (projects, tasks, agents, app files) | **Hosted MCP** at `https://www.taskade.com/mcp` | Hosted HTTP · personal token · Starter+ | -| Run MCP **locally / offline** (v1 surface, no app file editing) | **Stdio npm** `@taskade/mcp-server` (this repo) | Local stdio · personal token · most plans | +| Run MCP **locally via stdio** (v1 surface, no app file editing) | **Stdio npm** `@taskade/mcp-server` (this repo) | Local stdio · personal token · most plans | | Let my agents reach Slack / Shopify / Gmail | **[MCP Connectors](https://github.com/taskade/docs/blob/main/genesis-living-system-builder/genesis/mcp-connectors.md)** | Hosted, in-product | ### 1. Get Your API Key From 5f65e329cfff5ce200272face9be456e15bfdc5a Mon Sep 17 00:00:00 2001 From: johnxie Date: Thu, 17 Sep 2026 03:14:42 -0700 Subject: [PATCH 3/3] fix(docs): Hosted MCP tool count is 48 after Phase A 44 Phase A Public API v2 ops plus 4 MCP-native tools. Aligns with taskcade#29494 so Cursor users are not told the hosted surface is 32. Co-authored-by: Cursor --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 51ec554..da66a96 100644 --- a/README.md +++ b/README.md @@ -217,7 +217,7 @@ Hosted tools cover workspace browse (`list_spaces`, `inspect_space`), project/ag ## Tools (62) -> **Tool count tracks the hosted server.** The hosted MCP at `/mcp` currently exposes 32 tools (28 Public API v2 ops + 4 MCP-native: `inspect_space`, `write_file`, `read_project`, `list_automations`). The stdio npm package in this repo wraps the v1 API and exposes 14 ops. For the full workspace surface including app-file editing, use the hosted URL above. +> **Tool count tracks the hosted server.** The hosted MCP at `/mcp` currently exposes 48 tools (44 Phase A Public API v2 ops + 4 MCP-native: `inspect_space`, `write_file`, `read_project`, `list_automations`). The stdio npm package in this repo wraps the v1 API and exposes 14 ops. For the full workspace surface including app-file editing, use the hosted URL above. ### Workspaces