Skip to content

Conversation

@jonathannorris
Copy link
Member

@jonathannorris jonathannorris commented Jul 17, 2025

feat: add dashboard links to MCP tools

This PR enhances the Model Context Protocol (MCP) server tools by adding dashboard links to all tool responses, making it easier for AI assistants to direct users to the appropriate DevCycle dashboard pages.

Key Changes

  • Add helper functions to generate dashboard links for environments, features, projects, variables, and self-targeting
  • Enhance all MCP tool output schemas to include dashboardLink property
  • Implement executeWithDashboardLink method in API client to consistently append dashboard URLs
  • Update all tool handlers to use the new dashboard link functionality

Benefits

  • 🔗 AI assistants can now provide direct links to relevant dashboard pages
  • ✨ Improved user experience with seamless navigation between CLI and web interface
  • 🎯 Consistent dashboard link format across all MCP tools
  • 🛡️ Enhanced tool output schemas for better type safety

This comment was marked as outdated.

@jonathannorris jonathannorris changed the base branch from chore-mcp-planning-doc to main July 17, 2025 17:31
@jonathannorris jonathannorris changed the base branch from main to chore-mcp-planning-doc July 17, 2025 18:01
@jonathannorris jonathannorris requested a review from Copilot July 17, 2025 18:02
Copy link

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR enhances the MCP server tools to consistently include direct DevCycle dashboard links in every tool response.

  • Added executeWithDashboardLink in the API client to wrap operations and append a dashboardLink.
  • Introduced resource-specific helper functions to generate dashboard URLs for variables, environments, projects, features, and self-targeting.
  • Updated all tool definitions and handlers to integrate dashboardLink into their output schemas and return values.

Reviewed Changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
src/mcp/utils/api.ts Introduce executeWithDashboardLink for consistent link handling
src/mcp/tools/variableTools.ts Add dashboard link schemas, helper, and handler updates for variables
src/mcp/tools/selfTargetingTools.ts Add dashboard link schemas, helper, and handler updates for self-targeting
src/mcp/tools/projectTools.ts Add dashboard link schemas, helpers, and handler updates for projects
src/mcp/tools/featureTools.ts Add dashboard link schemas, helpers, and handler updates for features
src/mcp/tools/environmentTools.ts Add dashboard link schemas, helper, and handler updates for environments
oclif.manifest.json Bump CLI manifest version
Comments suppressed due to low confidence (1)

src/mcp/utils/api.ts:73

  • Consider adding unit tests for executeWithDashboardLink to ensure that API calls correctly return both the result and the appended dashboardLink under various scenarios (success, failure, edge cases).
    public async executeWithDashboardLink<T>(

@jonathannorris jonathannorris merged commit b376f7d into chore-mcp-planning-doc Jul 17, 2025
8 checks passed
@jonathannorris jonathannorris deleted the feat-dashboard-links branch July 17, 2025 20:38
jonathannorris added a commit that referenced this pull request Jul 23, 2025
…462)

* feat: add dashboard links and output schemas to environmentTools.ts

* feat: dashboard links working

* feat: update projectTools with dashboard links

* feat: update self targeting tools with dashboard links

* feat: update variableTools

* chore: cleanup ouput schemas

* feat: update featureTools.ts with dashboard links and input/output schemas

* fix: add oclif.manifest file back

* chore: cleanup tool calls

* chore: update feature list query params
jonathannorris added a commit that referenced this pull request Jul 25, 2025
…462)

* feat: add dashboard links and output schemas to environmentTools.ts

* feat: dashboard links working

* feat: update projectTools with dashboard links

* feat: update self targeting tools with dashboard links

* feat: update variableTools

* chore: cleanup ouput schemas

* feat: update featureTools.ts with dashboard links and input/output schemas

* fix: add oclif.manifest file back

* chore: cleanup tool calls

* chore: update feature list query params
jonathannorris added a commit that referenced this pull request Aug 11, 2025
…462)

* feat: add dashboard links and output schemas to environmentTools.ts

* feat: dashboard links working

* feat: update projectTools with dashboard links

* feat: update self targeting tools with dashboard links

* feat: update variableTools

* chore: cleanup ouput schemas

* feat: update featureTools.ts with dashboard links and input/output schemas

* fix: add oclif.manifest file back

* chore: cleanup tool calls

* chore: update feature list query params
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

3 participants