Skip to content

docs: document per-call projectKey on MCP tools and fix parameter drift - #1003

Merged
jonathannorris merged 1 commit into
mainfrom
docs-mcp-project-key
Sep 25, 2026
Merged

jonathannorris merged 1 commit into
mainfrom
docs-mcp-project-key

Conversation

@jonathannorris

Copy link
Copy Markdown
Member

Summary

  • Document the optional projectKey parameter on all 18 project-scoped MCP tools, added in DevCycleHQ/cli#589. It takes precedence over the project set by select_project, and is how stateless MCP hosts that start a new session per request can target a project.
  • Add a "Targeting a project" callout covering the two options, and note on select_project that its selection is session-scoped.
  • Fix pre-existing drift against the tool schemas: update_feature was missing configurations and summary; list_variables was missing sortBy, sortOrder, feature, type and status; create_variable and update_variable were each missing persistent and tags.
  • Remove platform and variable from get_project_total_evaluations; those only exist on get_feature_total_evaluations.
  • Remove list_projects, which is disabled in the server and registered nowhere, so it cannot be called.

Related Issues

Relates to: DevCycleHQ/cli#589

@jonathannorris
jonathannorris marked this pull request as ready for review September 24, 2026 19:01
@jonathannorris
jonathannorris requested review from cdruxerman, kaushalkapasi and leslie-lau and a lite review from Copilot and removed request for Copilot September 24, 2026 19:01
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying devcycle-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1def868
Status: ✅  Deploy successful!
Preview URL: https://115c753d.devcycle-docs.pages.dev
Branch Preview URL: https://docs-mcp-project-key.devcycle-docs.pages.dev

View logs

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot review overview

🔵 Needs a closer look

Two documentation inaccuracies remain regarding local project persistence and the unsupported summary parameter.

Review effort: Lite
Findings: None

What changed in this PR

Documents per-call projectKey support and updates MCP tool documentation to match current schemas.

Changes:

  • Adds project-targeting guidance and session behavior.
  • Corrects tool parameters and removes invalid evaluation filters.
  • Removes the unregistered list_projects tool.
File Summary
docs/​cli-mcp/​mcp-reference.md Updates the MCP tool reference and project-targeting guidance.
docs/​cli-mcp/​mcp-getting-started.md Removes list_projects from the tool overview.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@jonathannorris
jonathannorris merged commit ab3996b into main Sep 25, 2026
7 checks passed
@jonathannorris
jonathannorris deleted the docs-mcp-project-key branch September 25, 2026 14:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants