Temporal MCP Server
Provides tools for interacting with Temporal Cloud, enabling listing, describing, terminating workflows, and retrieving step results across multiple regions.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Temporal MCP ServerGet step results for workflow 'refresh-monitors-456' run 'abc-123' in EU region"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Temporal MCP Server
A Model Context Protocol (MCP) server for Temporal Cloud that enables Claude Code to interact with your Temporal workflows across all regions.
๐ Multi-Region Support
Access different Temporal Cloud regions:
๐บ๐ธ US (us-west-2)
๐ช๐บ EU (eu-central-1)
๐ฆ๐บ AU (ap-southeast-2)
๐ฎ๐ณ IN (ap-south-1)
Related MCP server: Workload Manager MCP Server
๐ Quick Setup
1. Configure Environment
Copy .env.example and setup the values
2. Add to Claude Code
Edit ~/.claude.json:
{
"mcpServers": {
"temporal": {
"command": "node",
"args": ["/absolute/path/to/your/temporal-mcp/build/index.js"],
"env": {
"TEMPORAL_API_KEY": "your-actual-api-key",
"TEMPORAL_ACCOUNT_ID": "<cloud_account_id>",
"DEFAULT_REGION": "us"
}
}
}
}3. Restart Claude Code
That's it! The server auto-connects to any region based on your queries.
๐ ๏ธ Available Tools
1. get_workflow_step_results โญ (Recommended)
Get processed step results with resultUri for downloading logs - use this instead of full history!
Use when: You want step summaries, resultUri, durations, or to debug flows Returns: Compact JSON with step names, resultUri, success status, durations
"Get step results for workflow 'refresh-monitors-456' run 'abc-123' in EU region"Response:
{
"success": true,
"totalSteps": 3,
"steps": [
{
"stepName": "fetchData",
"isSuccess": true,
"resultUri": "flowData/99/99999/flow-id/run-id/step-fetchData/1234567890.json",
"durationSeconds": "2.45",
"exposedData": { "count": 150 }
}
]
}2. list_workflow_executions
Query workflows with filters using Temporal visibility syntax.
{
"query": "WorkflowType='refreshSlackUsersFlow' AND ExecutionStatus='Running'",
"pageSize": 20,
"region": "eu"
}Example queries:
"ExecutionStatus='Running'"- All running workflows"ExecutionStatus='Failed' AND StartTime > '2026-02-01T00:00:00Z'"- Recent failures"WorkflowType='refreshGithubUsersFlow'"- Specific workflow type
3. describe_workflow_execution
Get workflow status, timing, and metadata.
{
"workflowId": "my-workflow-123",
"region": "us"
}4. terminate_workflow_execution
Stop a running workflow.
{
"workflowId": "stuck-workflow",
"reason": "Manual termination - investigating data source issue",
"region": "au"
}5. list_closed_workflow_executions
List workflows that completed in a time range.
{
"startTime": "2026-02-01T00:00:00Z",
"endTime": "2026-02-05T23:59:59Z",
"region": "in"
}6. get_workflow_execution_history
Get raw Temporal event history - only use if you need full history!
Warning: Can be 80k+ characters. Use get_workflow_step_results instead.
๐ก Usage Examples
Get Step Results with ResultUri (Most Common)
"Use temporal MCP and get step results for workflow 'intune.refreshIntuneEntitiesFlow.orgPk_756d...' run 'abc-123' and show me the resultUri for each step"Debug Failed Flow
"Show me failed workflows in EU region from last 24 hours, then get step results for the most recent failure"Monitor Specific Flow
"Is the GitHub user sync running for org 12345 in US region?"Cross-Region Health Check
"Compare total running workflows across all regions"Performance Analysis
"Get step results for the last 5 runs of 'refreshSlackUsersFlow' in US region and show me average step durations"๐ Region Handling
All tools accept an optional region parameter:
{ "region": "us" } // United States (default)
{ "region": "eu" } // Europe
{ "region": "au" } // Australia
{ "region": "in" } // IndiaWithout region: Uses DEFAULT_REGION from config
Natural language: Claude understands "EU region", "Australia", etc.
Automatic Mapping
The server automatically maps regions to endpoints No manual configuration needed!
๐ง Technical Details
What get_workflow_step_results Does
Fetches workflow history from Temporal
Filters for activity completed/failed events
Decodes base64 payloads โ JSON
Extracts stepName, resultUri, exposedData
Calculates step durations
Deduplicates by step name
Returns compact summary
Connection Management
Lazy-loads connections (only connects when needed)
Maintains separate connection per region
Reuses connections automatically
First query to a region: ~1-2 seconds
Subsequent queries: Fast (cached connection)
Event Types Processed
Event Type 12: Activity Task Completed
Event Type 13: Activity Task Failed
Event Type 3: Workflow Execution Failed
๐ฏ Best Practices
โ Do This
Use
get_workflow_step_resultsfor most queriesSpecify region when known
Use natural language with Claude
Download logs via resultUri
โ Avoid This
Using
get_workflow_execution_historyunless neededParsing raw history manually
Forgetting to specify region for known workflows
๐ Common Patterns
Pattern 1: Debugging Failed Flows
1. "List failed flows from last hour in US region"
2. "Get step results for workflow XYZ run ABC"
3. Use resultUri to download logs
4. Analyze error from step dataPattern 2: Performance Investigation
1. "Get step results for last 5 successful runs"
2. "Compare step durations"
3. "Identify slowest steps"Pattern 3: Cross-Region Monitoring
1. "Query all regions for specific workflow type"
2. "Aggregate results by region"
3. "Identify regional differences"๐ Troubleshooting
"Can't find workflow"
โ Try searching other regions or verify workflow ID
"Connection error"
โ Check API key and account ID in config
"Response too large"
โ Use get_workflow_step_results instead of full history
"Region not working"
โ Verify region code is one of: us, eu, au, in
๐ Response Format
All responses include region information:
{
"success": true,
"region": "eu",
"namespace": "your_temporal_host.<cloud_account_id>",
"data": { ... }
}Step results also include:
{
"totalSteps": 3,
"steps": [
{
"stepName": "...",
"isSuccess": true,
"resultUri": "...",
"durationSeconds": "2.45",
"exposedData": { ... }
}
]
}๐ฆ Getting Started
Add your API key to
.envUpdate Claude Code config with paths and credentials
Restart Claude Code
Test:
"List workflows in US region"Get step results:
"Get step results for workflow X run Y"Use resultUri to download logs
๐ Quick Examples
Simple:
"List running workflows"With region:
"Show failed workflows in EU from today"Get step results:
"Get step results for workflow X run Y and show me resultUri"Cross-region:
"Search all regions for workflow containing 'github'"Performance:
"Compare execution times between US and EU regions"Ready to use! Just add your API key and start debugging workflows with Claude! ๐
Available Tools
7 toolsdescribe_workflow_executionC
Get detailed information about a workflow execution including its current status, history length, start time, close time, and more.
| Name | Required | Description | Default |
|---|---|---|---|
| runId | No | Optional run ID. If not provided, describes the latest run for this workflow ID. | |
| region | No | Region to query. Defaults to "us" if not specified. | |
| workflowId | Yes | The workflow ID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the behavioral disclosure burden. It states what information is returned, but it does not explicitly say the operation is read-only, describe error behavior, or explain edge cases such as what happens when the workflow does not exist or when no run has occurred.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence that efficiently states the tool's purpose and lists useful output fields. The trailing 'and more' adds mild vagueness, but overall the description is concise and appropriately structured.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The description covers the main purpose and some return fields, and the schema fully documents all parameters. However, with no output schema, no annotations, and no distinction from sibling history tools, the description is not fully self-sufficient for an agent trying to choose among the related tools.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the parameter meanings are already fully documented. The description adds no parameter-specific detail beyond the schema, making the baseline 3 appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb and resource: 'Get detailed information about a workflow execution,' followed by concrete data points like status, history length, start time, and close time. It is clear about what the tool does, though it does not explicitly differentiate itself from the history-focused sibling tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives no guidance about when to use this tool versus sibling tools such as get_workflow_execution_history or list_workflow_executions. It also doesn't mention that omitting runId returns the latest run or that region defaults to 'us'โthose details are only in the schema, not in usage guidance.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
fetch_workflow_historyB
Convenience method to fetch complete workflow history using the workflow handle. Similar to get_workflow_execution_history but may be easier to use when you only have the workflow ID.
| Name | Required | Description | Default |
|---|---|---|---|
| runId | No | Optional run ID. If not provided, fetches history of the latest run. | |
| region | No | Region to query. Defaults to "us" if not specified. | |
| workflowId | Yes | The workflow ID |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description bears the full burden of behavioral disclosure. It only says this is a convenience method that fetches 'complete workflow history' and is similar to another tool; it does not explain the meaning of 'complete', what is returned, which run is used by default, or any error/edge-case behavior. The schema mentions 'latest run' but the description itself is vague.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The definition is appropriately short and front-loaded: the first clause states the core action, and the second sentence provides routing guidance. The hedge 'may be easier' and the undefined 'workflow handle' add mild ambiguity, but no sentence is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no output schema, no annotations, and no return-value description, the agent is left to infer what 'complete workflow history' actually contains. There is also a potential ambiguity between 'complete workflow history' and the schema's fact that only the latest run is fetched when runId is omitted. The description does not resolve this, making it incomplete for safe invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the baseline is 3 even without parameter detail in the description. The description adds little beyond identifying workflowId as the ID-based handle, and its 'workflow handle' wording is somewhat inconsistent with the actual parameter name. The schema already documents runId and region well.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear action and resource: 'fetch complete workflow history' and distinguishes this from get_workflow_execution_history by positioning it as easier 'when you only have the workflow ID.' However, the phrase 'using the workflow handle' introduces an undefined term that the schema calls workflowId, which slightly weakens the otherwise specific purpose.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It explicitly names the closest alternative, get_workflow_execution_history, and gives a use-case condition for choosing this tool: 'easier to use when you only have the workflow ID.' It does not state when not to use it or describe exclusion cases, but the guidance is clear enough for routing.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_workflow_execution_historyA
Get the complete RAW execution history of a Temporal workflow. Returns all events from the workflow history including activity executions, signals, timers, etc. WARNING: This can be very large. Use get_workflow_step_results instead for a compact summary with resultUri.
| Name | Required | Description | Default |
|---|---|---|---|
| runId | Yes | The run ID of the specific workflow execution. This is a UUID that uniquely identifies a workflow run. | |
| region | No | Region where the workflow is running. Options: us (US West), eu (EU Central), au (Australia), in (India). Defaults to "us" if not specified. | |
| workflowId | Yes | The workflow ID (e.g., "my-workflow-123") |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full burden of behavioral disclosure. It clearly discloses that the result is complete and raw, includes all event types, and can be very large, which is valuable context. It does not mention pagination or output format, but the size warning is substantive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three short sentences, front-loaded with the core function, followed by a necessary warning and a pointer to an alternative. Every sentence earns its place with no wasted words.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Covers the core function and points to a clear alternative for compact summaries, but leaves the relationship with the fetch_workflow_history sibling unexplained and provides no return-format or pagination hints. For a tool with no annotations and no output schema, this is a moderate gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents all three parameters including the region enum. The description adds no additional parameter-level details, so the baseline score of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb and resource: get the complete RAW execution history of a Temporal workflow, listing event types such as activity executions, signals, and timers. However, the sibling 'fetch_workflow_history' appears nearly identical and is not differentiated, so it falls short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Explicitly routes to get_workflow_step_results for a compact summary with resultUri, and warns about the large size of the response. Does not address when to choose this over the similarly named fetch_workflow_history sibling, so the guidance is not fully exhaustive.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_workflow_step_resultsA
Get processed step results from a workflow execution including resultUri, step names, durations, and success status. This is a compact summary perfect for analyzing what happened in each step without the full raw history. Use this to get the resultUri for downloading detailed step logs.
| Name | Required | Description | Default |
|---|---|---|---|
| runId | Yes | The run ID of the specific workflow execution. This is a UUID that uniquely identifies a workflow run. | |
| region | No | Region where the workflow is running. Options: us (US West), eu (EU Central), au (Australia), in (India). Defaults to "us" if not specified. | |
| workflowId | Yes | The workflow ID (e.g., "my-workflow-123") |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the burden of behavioral disclosure. It clearly conveys that the tool returns a processed, compact summary rather than raw history, and that it exposes resultUri for further log downloads. It does not discuss errors, pagination, or permissions, but these are minimal for a read-only getter.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three sentences, each earning its place: what it does, why it is useful, and a concrete use case. No filler or repetition beyond the intentional emphasis on resultUri.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema exists, but the description lists the key return elements (resultUri, step names, durations, success status) and clearly situates the tool among history-focused siblings. It is sufficient for an agent to select and call the tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the parameters are already well-documented. The description adds no additional meaning about how workflowId, runId, or region interact with the output, so baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Get') and resource ('processed step results from a workflow execution'), and lists concrete output fields (resultUri, step names, durations, success status). It also distinguishes itself from history tools by emphasizing it is a 'compact summary' rather than the 'full raw history'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides clear context for when to use the tool: for analyzing step outcomes and for retrieving resultUri to download logs. It implies a contrast with full-history alternatives but does not explicitly name sibling tools or state when not to use them.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_closed_workflow_executionsA
List workflow executions that have closed (completed, failed, terminated, etc.) within a specific time range.
| Name | Required | Description | Default |
|---|---|---|---|
| region | No | Region to query. Defaults to "us" if not specified. | |
| endTime | Yes | End time in ISO 8601 format (e.g., "2024-01-31T23:59:59Z") | |
| pageSize | No | Maximum number of results to return (default: 100) | |
| startTime | Yes | Start time in ISO 8601 format (e.g., "2024-01-01T00:00:00Z") |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the behavioral disclosure burden. It usefully explains that closed means completed, failed, terminated, etc., but it does not mention ordering, pagination results, region defaulting, or any rate/safety considerations. A borderline adequate disclosure.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single sentence, front-loaded with the core action, and the parenthetical status list is compact and informative. There is no wasted wording.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The combination of schema and description is sufficient for a basic invocation: required times are clear, defaults are in the schema, and the resource type is named. However, there is no output schema and the description does not describe return shape, paging behavior, or when to prefer this over list_workflow_executions, leaving meaningful gaps.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema covers all four parameters with descriptions, formats, defaults, and enums (100% coverage), so the description does not need to explain parameter semantics. It adds no param-specific detail beyond the time range, matching the baseline.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('List'), a specific resource ('workflow executions'), and a clear qualifier ('closed โ completed, failed, terminated, etc'), which differentiates it from sibling list_workflow_executions. The time-range constraint is also stated clearly.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description makes the intended context clear: use when you need executions that have already closed within a specified time range. It does not explicitly name alternatives or exclusions, but the state filter and time range are enough context to guide selection.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_workflow_executionsB
List workflow executions with optional filtering using Temporal visibility query syntax. Can filter by workflow type, status, start time, etc.
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Temporal visibility query (e.g., "WorkflowType='MyWorkflow' AND ExecutionStatus='Running'"). Leave empty to list all workflows. | |
| region | No | Region to query. Options: us (US West), eu (EU Central), au (Australia), in (India). Defaults to "us" if not specified. | |
| pageSize | No | Maximum number of results to return (default: 10, max: 1000) |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are present, so the description must carry the full burden of behavioral disclosure. It does mention Temporal visibility query syntax and optional filtering, but it does not state that the operation is read-only, what the return shape is, whether there are pagination implications, or what happens with an invalid query. This is insufficient for a tool with no annotation safety signals.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise, front-loaded with the action and resource, and uses two short sentences with no wasted words. Every sentence adds useful information about the tool's behavior.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that there is no output schema, no annotations, and a close sibling 'list_closed_workflow_executions', the description is not complete enough. It fails to clarify whether this tool lists only open, only closed, or all executions, and it does not explain return behavior. An agent could easily pick the wrong tool or miss important listing semantics.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the parameters 'query', 'region', and 'pageSize' are already fully documented with defaults and enums in the schema. The description adds only high-level filter categories and no parameter-specific detail beyond that, so the baseline score of 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('List'), a resource ('workflow executions'), and the key capability of optional filtering using Temporal visibility query syntax. It is clear what the tool does, but it does not distinguish itself from the sibling 'list_closed_workflow_executions', so it stops short of full sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies when to use the tool: when you need to list workflow executions and optionally filter by workflow type, status, start time, etc. However, it provides no explicit exclusions or comparison with alternatives such as 'list_closed_workflow_executions', so the guidance remains implicit rather than explicit.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
terminate_workflow_executionA
Terminate a running workflow execution. This immediately stops the workflow and marks it as terminated.
| Name | Required | Description | Default |
|---|---|---|---|
| runId | No | Optional run ID. If not provided, terminates the latest run. | |
| reason | No | Reason for termination (optional) | |
| region | No | Region where the workflow is running. Defaults to "us" if not specified. | |
| workflowId | Yes | The workflow ID to terminate |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the behavioral disclosure burden. It does disclose that termination is immediate and that the workflow is marked as terminated. However, it does not mention irreversibility, required permissions, or side effects, which would be valuable for a mutating tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is two short sentences with no filler. The action and primary consequence are front-loaded, and every word contributes to understanding the tool's behavior.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple termination action with fully documented parameters, the description is mostly adequate. However, with no annotations and no output schema, it could be more complete by noting that termination is irreversible and that only running executions are affected.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the input schema already fully documents all four parameters. The description adds no parameter-level meaning beyond that, so the baseline score of 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ('Terminate') and resource ('running workflow execution'), and adds the key consequence: it stops immediately and marks the execution as terminated. This clearly differentiates the tool from its read-only siblings (list/get/describe/fetch history).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The phrase 'running workflow execution' gives clear context for when to use this tool. It does not explicitly name alternatives or exclusion cases, but none of the sibling tools perform termination, so the usage intent is unambiguous.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
Several tools are clearly distinct, but there is notable overlap: fetch_workflow_history largely duplicates get_workflow_execution_history, and list_closed_workflow_executions is a specialized subset of list_workflow_executions. Descriptions help clarify the differences, but an agent could easily pick the wrong tool.
Tool names consistently follow a verb_noun pattern using snake_case: get, list, describe, fetch, terminate. The naming is predictable and readable, with only a minor stylistic variation between get and fetch.
With 7 tools, the server is well-scoped for workflow inspection and management. Each tool covers a meaningful operation without unnecessary bloat.
The tool set covers workflow observation well: listing, describing, raw history, and step summaries. However, it lacks common lifecycle operations such as starting, signaling, canceling, or querying workflows, and terminate is the only mutation available.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server for building and testing AI agents with multi-model experimentation and insights.
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for generating rough-draft project plans from natural-language prompts.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceAn MCP (Multi-Agent Conversation Protocol) Server that enables interaction with Google Workflows API, allowing management of workflow executions and definitions through natural language commands.
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables interaction with Google Cloud's Workload Manager API, allowing users to manage workloads through natural language commands.
- FlicenseNot gradedqualityCmaintenanceMulti-cloud MCP server that exposes cloud AI models as tools for AI CLI agents, supporting streaming, conversation history, parallel multi-model queries, and dynamic model discovery.2
- FlicenseAqualityDmaintenanceAn MCP server for debugging Temporal workflows, enabling LLM-assisted inspection of workflow executions, detailed workflow info, and event history.3
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/shimantakb-sprinto/temporal-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server