{"id":"temporal-mcp-server","name":"temporal-mcp-server","homepage":"https://pypi.org/project/temporal-mcp-server/","repo_url":"https://github.com/GethosTheWalrus/temporal-mcp","category":"infrastructure","subcategories":[],"tags":["mcp","temporal","workflow-orchestration","python","workflow-control","scheduling","api-tools","devtools","automation"],"what_it_does":"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.","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"],"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.","alternatives":["Temporal Python SDK (temporalio) directly","Temporal Web UI / CLI for operational tasks","A custom MCP server tailored to your specific Temporal usage patterns and safety controls"],"af_score":51.2,"security_score":55.5,"reliability_score":26.2,"package_type":"mcp_server","discovery_source":["pypi"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T21:42:24.410203+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":["Python"],"openapi_spec_url":null,"webhooks":false},"auth":{"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":false,"scopes":false,"notes":"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":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"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."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":51.2,"security_score":55.5,"reliability_score":26.2,"mcp_server_quality":70.0,"documentation_accuracy":65.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":55.0,"rate_limit_clarity":10.0,"tls_enforcement":85.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":45.0,"secret_handling":70.0,"security_notes":"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.","uptime_documented":0.0,"version_stability":55.0,"breaking_changes_history":30.0,"error_recovery":20.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"limit/skip","retry_guidance_documented":false,"known_agent_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."]}}