You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
packages/server/README.md (the npm package README) is stale and thin — "MCP server for Taskade's public API," no tool count, no v2, no surface note — and contradicts the polished root README. npm readers hit it and never reach the real story. Per the roadmap, the fix is stub-and-link rather than parity: two full READMEs would only drift again.
What changed
Before
After
Thin standalone README ("MCP server for Taskade's public API"), no tool count / no v2 / raw JSON token placeholder
Concise stub: names it Workspace MCP, states 62 tools, links the root README + Workspace MCP guide + the "which MCP" guide; keeps a minimal quick-start + canonical token link
Why it matters (the David cohort)
The npm/package reader gets the correct product name, the real tool count, and one click to the full docs — instead of a contradictory stub.
Design lens
Geist — one canonical server doc; eliminate the second source of truth that drifts.
Verification / zero-regression
Intentional content reduction (stub-and-link is the chosen strategy).
Token URL is the canonical https://www.taskade.com/settings/api.
No second 62-tool table authored; package.json untouched.
Merge order
Independent of M1. Note: M2 deliberately does NOT touch this file (to avoid a conflict) — M3 carries the correct "Workspace MCP" naming for the package README.
🤖 Authored with Claude Code (multi-agent verified)
Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.
This PR includes no changesets
When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types
Approve — the optional link-text nit is now fixed.
Verification notes:
Diff scope confirmed: only packages/server/README.md (+11/−63); package.json untouched.
All four links return HTTP 200: root README (github.com/taskade/mcp#readme), workspace-mcp.md, genesis-app-mcp.md, and the canonical token URL https://www.taskade.com/settings/api.
Claims accurate: "Workspace MCP", "62 tools", package name @taskade/mcp-server, and the npx -y @taskade/mcp-server quick-start all match the package and ground truth; the "which MCP" bullet correctly reflects the Workspace vs Genesis App vs Connectors surfaces.
Intentional content reduction (stub-and-link), and the github.com/taskade/docs/blob/main source URLs are by design.
Update: the optional nit — the Workspace MCP guide bullet's link text read docs.taskade.com while its href is a github.com/taskade/docs/... source URL — is now fixed; the link text matches its destination.
Reviewed via a two-lens pass (pr-review-toolkit:code-reviewer + an independent doc-correctness/link verifier) with adversarial verification.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
packages/server/README.md(the npm package README) is stale and thin — "MCP server for Taskade's public API," no tool count, no v2, no surface note — and contradicts the polished root README. npm readers hit it and never reach the real story. Per the roadmap, the fix is stub-and-link rather than parity: two full READMEs would only drift again.What changed
Why it matters (the David cohort)
The npm/package reader gets the correct product name, the real tool count, and one click to the full docs — instead of a contradictory stub.
Design lens
Geist — one canonical server doc; eliminate the second source of truth that drifts.
Verification / zero-regression
https://www.taskade.com/settings/api.package.jsonuntouched.Merge order
Independent of M1. Note: M2 deliberately does NOT touch this file (to avoid a conflict) — M3 carries the correct "Workspace MCP" naming for the package README.
🤖 Authored with Claude Code (multi-agent verified)