temporal-mcp-server

Provides a Model Context Protocol (MCP) server exposing tools for managing Temporal workflow orchestration (start/query/control/history) and schedule management. Supports running against local or remote Temporal instances, with Docker or PyPI-based execution, and configurable connection/TLS/API key settings.

Evaluated Apr 04, 2026 (16d ago)
Homepage ↗ Repo ↗ Infrastructure mcp temporal workflow-orchestration python workflow-control scheduling api-tools devtools automation
⚙ Agent Friendliness
51
/ 100
Can an agent use this?
🔒 Security
56
/ 100
Is it safe for agents?
⚡ Reliability
26
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
70
Documentation
65
Error Messages
0
Auth Simplicity
55
Rate Limits
10

🔒 Security

TLS Enforcement
85
Auth Strength
55
Scope Granularity
20
Dep. Hygiene
45
Secret Handling
70

Supports TLS-related configuration (including mTLS client cert/key) and an API key for connecting to Temporal. README does not detail how secrets are logged/handled internally, nor does it describe authorization scopes/RBAC for MCP tools. Network exposure controls (e.g., bind address/firewall) and MCP-side auth are not documented here.

⚡ Reliability

Uptime/SLA
0
Version Stability
55
Breaking Changes
30
Error Recovery
20
AF Security Reliability

Best When

When you want a standardized MCP interface to Temporal that can be consumed by MCP clients (e.g., IDEs/agents) to orchestrate workflows and schedules programmatically.

Avoid When

When you require a fully documented REST/SDK experience, OAuth-style delegated authorization, or guaranteed idempotency/retry semantics for every operation.

Use Cases

  • Letting AI agents start Temporal workflows and await results
  • Enabling agent-driven workflow inspection (describe, query, history)
  • Agent-driven operational control (signal, cancel, terminate, continue-as-new)
  • Batch operations for signals/cancels/terminations over workflow queries
  • Managing Temporal schedules (create/list/pause/unpause/delete/trigger)

Not For

  • High-assurance production deployments without verifying operational safety and error handling semantics
  • Use as a public internet-facing service without proper network controls and transport security validation
  • Workloads requiring complex, fine-grained authorization beyond a single API key

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: TEMPORAL_API_KEY / --api-key (API key) mTLS client cert/key via TEMPORAL_TLS_CLIENT_CERT_PATH and TEMPORAL_TLS_CLIENT_KEY_PATH (client-side certificates)
OAuth: No Scopes: No

Authentication is described as a Temporal API key and/or mTLS configuration for the Temporal connection. The README does not describe MCP-side user auth, authorization scopes, or RBAC at the tool level.

Pricing

Free tier: No
Requires CC: No

No pricing information provided (open-source package implied by Apache-2.0, but no explicit statement). Costs would primarily be from running Temporal and operating MCP clients.

Agent Metadata

Pagination
limit/skip
Idempotent
False
Retry Guidance
Not documented

Known Gotchas

  • Operations like start_workflow/control actions are likely not inherently idempotent; agents may need to avoid duplicate starts and handle retries carefully.
  • Batch operations rely on query filters; agents should ensure queries are precise to avoid unintended workflow selection.
  • Pagination is indicated via limit/skip for list endpoints; agents should loop until completion to avoid truncated results.
  • Tool semantics (e.g., behavior of cancel/terminate/continue-as-new, and how results are represented) are not described in README, so agents may need to validate against Temporal behavior.

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for temporal-mcp-server.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-04-04.

8642
Packages Evaluated
17761
Need Evaluation
586
Need Re-evaluation
Community Powered