mcp/temporal

Verified Publisher

By mcp

•Updated 26 days ago

MCP support for Temporal. A comprehensive set of tools for interacting with workflows and their a...

Image

Machine learning & AI

10K+

View on MCP:Hub

Overview Tags

mcp/temporal repository overview

⁠Temporal MCP Server

MCP support for Temporal. A comprehensive set of tools for interacting with workflows and their adjacent configurations.

What is an MCP Server?⁠

⁠MCP Info

Attribute	Details
Docker Image	mcp/temporal⁠
Author	GethosTheWalrus⁠
Repository	https://github.com/GethosTheWalrus/temporal-mcp⁠

⁠Image Building Info

Attribute	Details
Dockerfile	https://github.com/GethosTheWalrus/temporal-mcp/blob/bbe92ebc4375aff5e5efff6ffd7b69db8956d92b/Dockerfile⁠
Commit	`bbe92ebc4375aff5e5efff6ffd7b69db8956d92b`
Docker Image built by	Docker Inc.
Docker Scout Health Score
Verify Signature	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/temporal --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
Licence	Apache License 2.0

⁠Available Tools (29)

Tools provided by this Server	Short Description
`batch_cancel`	Cancel multiple workflows matching a query with concurrent processing for speed.
`batch_cancel_activities`	Cancel multiple standalone activities matching a query with concurrent processing for speed.
`batch_signal`	Send a signal to multiple workflows matching a query.
`batch_terminate`	Terminate multiple workflows matching a query.
`batch_terminate_activities`	Terminate multiple standalone activities matching a query.
`cancel_activity`	Cancel a running standalone activity execution
`cancel_workflow`	Cancel a running workflow execution
`continue_as_new`	Signal a workflow to continue as new (restart with new inputs while preserving history link)
`count_activities`	Count standalone activity executions matching a query
`create_schedule`	Create a new schedule for periodic workflow execution
`delete_schedule`	Delete a schedule
`describe_activity`	Get detailed information about a standalone activity execution
`describe_workflow`	Get detailed information about a workflow execution
`execute_activity`	Execute a standalone Temporal activity and wait for result
`get_activity_result`	Get the result of a standalone activity
`get_workflow_history`	Get the complete event history of a workflow execution.
`get_workflow_result`	Get the result of a completed workflow
`list_activities`	List standalone activity executions based on a query.
`list_schedules`	List all schedules.
`list_workflows`	List workflow executions based on a query.
`pause_schedule`	Pause a schedule
`query_workflow`	Query a running workflow for its current state
`signal_workflow`	Send a signal to a running workflow
`start_activity`	Start a new standalone Temporal activity execution
`start_workflow`	Start a new Temporal workflow execution
`terminate_activity`	Forcefully terminate a standalone activity execution
`terminate_workflow`	Forcefully terminate a workflow execution
`trigger_schedule`	Manually trigger a scheduled workflow immediately
`unpause_schedule`	Resume a paused schedule

⁠Tools Details

⁠Tool: `batch_cancel`

Cancel multiple workflows matching a query with concurrent processing for speed. Use 'concurrency' to control parallel operations (default: 50).

Parameters	Type	Description
`query`	`string`	Query to select workflows to cancel
`concurrency`	`number` optional	Number of workflows to cancel concurrently for faster processing (default: 50, max recommended: 100)
`limit`	`number` optional	Maximum number of workflows to cancel (default: 100)

⁠Tool: `batch_cancel_activities`

Cancel multiple standalone activities matching a query with concurrent processing for speed. Use 'concurrency' to control parallel operations (default: 50).

Parameters	Type	Description
`query`	`string`	Query to select activities to cancel
`concurrency`	`number` optional	Number of activities to cancel concurrently (default: 50)
`limit`	`number` optional	Maximum number of activities to cancel (default: 100)

⁠Tool: `batch_signal`

Send a signal to multiple workflows matching a query. Specify 'limit' to control batch size (default: 100).

Parameters	Type	Description
`query`	`string`	Query to select workflows
`signal_name`	`string`	The signal name to send
`args`	`object` optional	Arguments for the signal
`limit`	`number` optional	Maximum number of workflows to signal (default: 100)

⁠Tool: `batch_terminate`

Terminate multiple workflows matching a query. Specify 'limit' to control batch size (default: 100).

Parameters	Type	Description
`query`	`string`	Query to select workflows to terminate
`limit`	`number` optional	Maximum number of workflows to terminate (default: 100)
`reason`	`string` optional	Reason for termination

⁠Tool: `batch_terminate_activities`

Terminate multiple standalone activities matching a query. Specify 'limit' to control batch size (default: 100).

Parameters	Type	Description
`query`	`string`	Query to select activities to terminate
`concurrency`	`number` optional	Number of activities to terminate concurrently (default: 50)
`limit`	`number` optional	Maximum number of activities to terminate (default: 100)
`reason`	`string` optional	Reason for termination

⁠Tool: `cancel_activity`

Cancel a running standalone activity execution

Parameters	Type	Description
`activity_id`	`string`	Standalone activity execution ID
`run_id`	`string` optional	Run ID for the standalone activity execution

⁠Tool: `cancel_workflow`

Cancel a running workflow execution

Parameters	Type	Description
`workflow_id`	`string`	The workflow execution ID to cancel

⁠Tool: `continue_as_new`

Signal a workflow to continue as new (restart with new inputs while preserving history link)

Parameters	Type	Description
`signal_name`	`string`	The signal name to send (must be handled by the workflow to trigger continue-as-new)
`workflow_id`	`string`	The workflow ID to continue as new
`signal_args`	`object` optional	Arguments for the signal that will trigger continue-as-new

⁠Tool: `count_activities`

Count standalone activity executions matching a query

Parameters	Type	Description
`query`	`string` optional	List filter query (e.g., 'TaskQueue = "my-task-queue"')

⁠Tool: `create_schedule`

Create a new schedule for periodic workflow execution

Parameters	Type	Description
`cron`	`string`	Cron expression (e.g., '0 12 * * *')
`schedule_id`	`string`	Unique identifier for the schedule
`task_queue`	`string`	Task queue for the workflow
`workflow_name`	`string`	Name of the workflow to schedule
`args`	`object` optional	Arguments for the workflow

⁠Tool: `delete_schedule`

Delete a schedule

Parameters	Type	Description
`schedule_id`	`string`	The schedule ID to delete

⁠Tool: `describe_activity`

Get detailed information about a standalone activity execution

Parameters	Type	Description
`activity_id`	`string`	Standalone activity execution ID
`run_id`	`string` optional	Run ID for the standalone activity execution

⁠Tool: `describe_workflow`

Get detailed information about a workflow execution

Parameters	Type	Description
`workflow_id`	`string`	The workflow execution ID to describe

⁠Tool: `execute_activity`

Execute a standalone Temporal activity and wait for result

Parameters	Type	Description
`activity`	`string`	Activity type name to execute
`activity_id`	`string`	Unique identifier for the activity execution
`task_queue`	`string`	Task queue for this activity
`args`	`object` optional	Arguments to pass to the activity
`start_to_close_timeout_seconds`	`number` optional	Activity start-to-close timeout in seconds

⁠Tool: `get_activity_result`

Get the result of a standalone activity

Parameters	Type	Description
`activity_id`	`string`	Standalone activity execution ID
`run_id`	`string` optional	Run ID for the standalone activity execution
`timeout`	`number` optional	Optional timeout in seconds while waiting for result

⁠Tool: `get_workflow_history`

Get the complete event history of a workflow execution. Specify 'limit' to control the number of events (default: 1000).

Parameters	Type	Description
`workflow_id`	`string`	The workflow execution ID
`limit`	`number` optional	Maximum number of history events to return (default: 1000)

⁠Tool: `get_workflow_result`

Get the result of a completed workflow

Parameters	Type	Description
`workflow_id`	`string`	The workflow execution ID

⁠Tool: `list_activities`

List standalone activity executions based on a query. Specify 'limit' to control results and 'skip' for pagination.

Parameters	Type	Description
`limit`	`number` optional	Maximum number of results to return (default: 100)
`query`	`string` optional	List filter query (e.g., 'TaskQueue = "my-task-queue"')
`skip`	`number` optional	Number of results to skip for pagination (default: 0)

⁠Tool: `list_schedules`

List all schedules. Specify 'limit' to control the number of results (default: 100). Use 'skip' to paginate through results.

Parameters	Type	Description
`limit`	`number` optional	Maximum number of schedules to return (default: 100)
`skip`	`number` optional	Number of results to skip for pagination (default: 0)

⁠Tool: `list_workflows`

List workflow executions based on a query. Specify 'limit' to control the number of results (default: 100, max recommended: 1000). Use 'skip' to paginate through results.

Parameters	Type	Description
`limit`	`number` optional	Maximum number of results to return (default: 100, increase for more results)
`query`	`string` optional	List filter query (e.g., 'WorkflowType="MyWorkflow"')
`skip`	`number` optional	Number of results to skip for pagination (default: 0)

⁠Tool: `pause_schedule`

Pause a schedule

Parameters	Type	Description
`schedule_id`	`string`	The schedule ID to pause
`note`	`string` optional	Note explaining why the schedule was paused

⁠Tool: `query_workflow`

Query a running workflow for its current state

Parameters	Type	Description
`query_name`	`string`	The name of the query to execute
`workflow_id`	`string`	The workflow execution ID to query
`args`	`object` optional	Arguments for the query (as JSON object)

⁠Tool: `signal_workflow`

Send a signal to a running workflow

Parameters	Type	Description
`signal_name`	`string`	The name of the signal to send
`workflow_id`	`string`	The workflow execution ID to signal
`args`	`object` optional	Arguments for the signal (as JSON object)

⁠Tool: `start_activity`

Start a new standalone Temporal activity execution

Parameters	Type	Description
`activity`	`string`	Activity type name to start
`activity_id`	`string`	Unique identifier for the activity execution
`task_queue`	`string`	Task queue for this activity
`args`	`object` optional	Arguments to pass to the activity
`start_to_close_timeout_seconds`	`number` optional	Activity start-to-close timeout in seconds

⁠Tool: `start_workflow`

Start a new Temporal workflow execution

Parameters	Type	Description
`task_queue`	`string`	The task queue to use for this workflow
`workflow_id`	`string`	Unique identifier for the workflow execution
`workflow_name`	`string`	The name of the workflow to start
`args`	`object` optional	Arguments to pass to the workflow (as JSON object)

⁠Tool: `terminate_activity`

Forcefully terminate a standalone activity execution

Parameters	Type	Description
`activity_id`	`string`	Standalone activity execution ID
`reason`	`string` optional	Reason for termination
`run_id`	`string` optional	Run ID for the standalone activity execution

⁠Tool: `terminate_workflow`

Forcefully terminate a workflow execution

Parameters	Type	Description
`workflow_id`	`string`	The workflow execution ID to terminate
`reason`	`string` optional	Reason for termination

⁠Tool: `trigger_schedule`

Manually trigger a scheduled workflow immediately

Parameters	Type	Description
`schedule_id`	`string`	The schedule ID to trigger

⁠Tool: `unpause_schedule`

Resume a paused schedule

Parameters	Type	Description
`schedule_id`	`string`	The schedule ID to unpause
`note`	`string` optional	Note explaining why the schedule was resumed

⁠Use this MCP Server

{
  "mcpServers": {
    "temporal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TEMPORAL_HOST",
        "-e",
        "TEMPORAL_NAMESPACE",
        "-e",
        "TEMPORAL_TLS_ENABLED",
        "-e",
        "TEMPORAL_TLS_CLIENT_CERT_PATH",
        "-e",
        "TEMPORAL_TLS_CLIENT_KEY_PATH",
        "-e",
        "TEMPORAL_API_KEY",
        "mcp/temporal"
      ],
      "env": {
        "TEMPORAL_HOST": "localhost:7233",
        "TEMPORAL_NAMESPACE": "default",
        "TEMPORAL_TLS_ENABLED": "false",
        "TEMPORAL_TLS_CLIENT_CERT_PATH": "/certs/client.pem",
        "TEMPORAL_TLS_CLIENT_KEY_PATH": "/certs/client.key",
        "TEMPORAL_API_KEY": ""
      }
    }
  }
}

Why is it safer to run MCP Servers with Docker?⁠

Install from MCP:Hub

Temporal

View and Install from MCP:Hub

Tag summary

Recent tags

Content type

Image

Digest

sha256:24aeaca7c…

Size

53.3 MB

Last updated

26 days ago

docker pull mcp/temporal

This week's pulls

Pulls:

1,264

Jul 6 to Jul 12

Learn more⁠

mcp/temporal

mcp/temporal repository overview

⁠Temporal MCP Server

⁠MCP Info

⁠Image Building Info

⁠Available Tools (29)

⁠Tools Details

⁠Tool: batch_cancel

⁠Tool: batch_cancel_activities

⁠Tool: batch_signal

⁠Tool: batch_terminate

⁠Tool: batch_terminate_activities

⁠Tool: cancel_activity

⁠Tool: cancel_workflow

⁠Tool: continue_as_new

⁠Tool: count_activities

⁠Tool: create_schedule

⁠Tool: delete_schedule

⁠Tool: describe_activity

⁠Tool: describe_workflow

⁠Tool: execute_activity

⁠Tool: get_activity_result

⁠Tool: get_workflow_history

⁠Tool: get_workflow_result

⁠Tool: list_activities

⁠Tool: list_schedules

⁠Tool: list_workflows

⁠Tool: pause_schedule

⁠Tool: query_workflow

⁠Tool: signal_workflow

⁠Tool: start_activity

⁠Tool: start_workflow

⁠Tool: terminate_activity

⁠Tool: terminate_workflow

⁠Tool: trigger_schedule

⁠Tool: unpause_schedule