Skip to main content
Glama

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

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" }  // India

Without 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

  1. Fetches workflow history from Temporal

  2. Filters for activity completed/failed events

  3. Decodes base64 payloads โ†’ JSON

  4. Extracts stepName, resultUri, exposedData

  5. Calculates step durations

  6. Deduplicates by step name

  7. 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_results for most queries

  • Specify region when known

  • Use natural language with Claude

  • Download logs via resultUri

โŒ Avoid This

  • Using get_workflow_execution_history unless needed

  • Parsing 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 data

Pattern 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

  1. Add your API key to .env

  2. Update Claude Code config with paths and credentials

  3. Restart Claude Code

  4. Test: "List workflows in US region"

  5. Get step results: "Get step results for workflow X run Y"

  6. 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 tools
describe_workflow_executionC

Get detailed information about a workflow execution including its current status, history length, start time, close time, and more.

ParametersJSON Schema
NameRequiredDescriptionDefault
runIdNoOptional run ID. If not provided, describes the latest run for this workflow ID.
regionNoRegion to query. Defaults to "us" if not specified.
workflowIdYesThe workflow ID

TDQS

C2.9/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines2/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
runIdNoOptional run ID. If not provided, fetches history of the latest run.
regionNoRegion to query. Defaults to "us" if not specified.
workflowIdYesThe workflow ID

TDQS

B3.3/5.0
Behavior2/5

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.

Conciseness4/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines4/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
runIdYesThe run ID of the specific workflow execution. This is a UUID that uniquely identifies a workflow run.
regionNoRegion where the workflow is running. Options: us (US West), eu (EU Central), au (Australia), in (India). Defaults to "us" if not specified.
workflowIdYesThe workflow ID (e.g., "my-workflow-123")

TDQS

A3.9/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines4/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
runIdYesThe run ID of the specific workflow execution. This is a UUID that uniquely identifies a workflow run.
regionNoRegion where the workflow is running. Options: us (US West), eu (EU Central), au (Australia), in (India). Defaults to "us" if not specified.
workflowIdYesThe workflow ID (e.g., "my-workflow-123")

TDQS

A4.2/5.0
Behavior4/5

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.

Conciseness5/5

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.

Completeness4/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
regionNoRegion to query. Defaults to "us" if not specified.
endTimeYesEnd time in ISO 8601 format (e.g., "2024-01-31T23:59:59Z")
pageSizeNoMaximum number of results to return (default: 100)
startTimeYesStart time in ISO 8601 format (e.g., "2024-01-01T00:00:00Z")

TDQS

A3.9/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
queryNoTemporal visibility query (e.g., "WorkflowType='MyWorkflow' AND ExecutionStatus='Running'"). Leave empty to list all workflows.
regionNoRegion to query. Options: us (US West), eu (EU Central), au (Australia), in (India). Defaults to "us" if not specified.
pageSizeNoMaximum number of results to return (default: 10, max: 1000)

TDQS

B3.2/5.0
Behavior2/5

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.

Conciseness5/5

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.

Completeness2/5

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.

Parameters3/5

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.

Purpose4/5

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.

Usage Guidelines3/5

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
runIdNoOptional run ID. If not provided, terminates the latest run.
reasonNoReason for termination (optional)
regionNoRegion where the workflow is running. Defaults to "us" if not specified.
workflowIdYesThe workflow ID to terminate

TDQS

A3.9/5.0
Behavior3/5

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.

Conciseness5/5

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.

Completeness3/5

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.

Parameters3/5

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.

Purpose5/5

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.

Usage Guidelines4/5

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

A3.5/5.0
Disambiguation3/5

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.

Naming Consistency5/5

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.

Tool Count5/5

With 7 tools, the server is well-scoped for workflow inspection and management. Each tool covers a meaningful operation without unnecessary bloat.

Completeness3/5

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

ActivityInactive
ResponsivenessSyncing

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

Related MCP Servers

Latest Blog Posts

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