docs: Add workflow MCP functions design document#69
Merged
Conversation
Add design specification for new MCP tools to monitor Digdag workflow execution states and retrieve failure data. The design includes: - 9 MCP tools for workflow monitoring, failure analysis, and retry operations - Comprehensive API endpoint resolution supporting all TD regions and environments - Authentication using existing TD API key mechanism - Error handling and security considerations - Testing plan for implementation Addresses #68 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
xerial
commented
Jun 30, 2025
| - Mask sensitive information in error responses | ||
|
|
||
| ### Configuration | ||
| - Workflow API endpoints follow the pattern based on the base API URL: |
Member
Author
There was a problem hiding this comment.
Use TD_SITE env as in the other functions
Add link to the official Digdag REST API documentation as requested in PR review. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
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
Add design specification for new MCP tools to monitor Digdag workflow execution states and retrieve failure data.
Changes
doc/design/2025-06-30-workflow-mcp-functions.mdcontaining the design for workflow monitoring MCP functionsDesign Overview
The design document specifies 9 new MCP tools:
Workflow Monitoring
list_workflows- List all workflows with statuslist_sessions- List workflow execution sessionsget_session_attempts- Get attempt detailsget_attempt_tasks- List tasks with execution statusFailure Analysis
get_task_logs- Retrieve task-specific logsget_attempt_logs- Get aggregated attempt logsWorkflow Control
kill_attempt- Cancel running attemptsretry_session- Retry failed sessionsretry_attempt- Retry specific attempts with resumeKey Features
Related Issue
Addresses #68
🤖 Generated with Claude Code