# Temporal Cloud — card for AI agents

Durable workflow orchestration platform for automating long-running processes.

Maker: Temporal · category: Integrations and automation

## Price (official page)
- Free tier: $150 credits for 90 days, no base monthly fee
- Free tier terms: free credits · monthly · card required · amount: $150 credits (read from the wording above and the pricing page; empty = not stated)
- Paid from $50/month
- Usage price: $50 per million actions
- About $0.05 per 1,000 requests
- Pricing page: https://temporal.io/pricing (checked 2026-10-09)
- Note: Added automatically: its SDK was in 16 of the public agent repos we sampled when it was added. Prices read from the official pricing page.

## Connect
- PyPI: `pip install temporalio`
- Repository: https://github.com/temporalio/sdk-python

## For AI agents on Temporal's own site (AgentGid check 2026-11-13: 3 of 6)
- llms.txt: https://temporal.io/llms.txt
- Docs pages as Markdown: 32% of the pages llms.txt lists
- OpenAPI description: none found at the usual places
- Official MCP server: no · official SDK: yes · status page: no
- robots.txt lets AI assistants (ChatGPT-User, Claude-User) read the site: yes

## A year of price history (Internet Archive copies of the pricing page, read by rules)
- Months read: 8 (2025-12 to 2026-09) of https://temporal.io/pricing
- Lowest $/month figure on the page: $100 in 2025-12, $100 in 2026-09
- A figure is any "$X/month" on the page (plans, seats and add-ons alike); open the archived copy to see which plan it is.

## Price history in AgentGid's catalog (since 2026-10-13)
- Changes recorded: 0 (a vendor price change or an editor's correction; the evidence archive keeps the pricing page of each date)

## Other APIs in this category
- Trigger.dev: https://agentgid.com/apis/trigger-dev/agent.md
- Inngest: https://agentgid.com/apis/inngest/agent.md
- Arcade: https://agentgid.com/apis/arcade/agent.md
- GitHub: https://agentgid.com/apis/github/agent.md
- Prefect Cloud: https://agentgid.com/apis/prefect/agent.md

## Links
- AgentGid page: https://agentgid.com/apis/temporal/


## Temporal Cloud: long processes that survive crashes

Temporal lets your app run long, multi-step processes, such as an order, a sign-up or an AI assistant's task, that carry on where they stopped after a crash or restart. Your own code runs on your machines, and Temporal Cloud is the hosted service that keeps track of each step. Temporal itself is open source and can also be run on your own servers.

### Where to use it
- Payments and orders that never half-finish: Charge the card, reserve stock and book delivery as one process; if a step fails, it is retried or the earlier steps are undone.
- Processes that wait days for a person: An approval, a document review or a booking that pauses until someone clicks, then carries on, even if your servers restarted meanwhile.
- AI assistants that resume after a crash: Each model call and tool call is a saved step, so a long agent task picks up the conversation instead of starting over and paying twice.
- Data and video processing pipelines: Split a big job, such as processing thousands of files, into many steps that run in parallel and resume without redoing finished work.
- Scheduled jobs and maintenance: Nightly reports, cleanups or account checks run on a schedule, with each run visible and retried when it fails.
- Welcome emails spread over weeks: Send a series of onboarding messages days apart for each new user, with no cron table to maintain and no lost steps after a restart. (idea, not from the official pages)

### How to start
- Install the Python package in a virtual environment (there are also Go, Java, TypeScript, .NET, PHP, Ruby and Rust packages).

```
pip install temporalio
```

- Start the free local development server; it runs the web screen at localhost:8233 and stores data only in memory.

```
temporal server start-dev
```

- For Temporal Cloud, sign up, create a Namespace with an API key, and connect with these environment variables.

```
export TEMPORAL_ADDRESS=<namespace>.<account>.tmprl.cloud:7233
export TEMPORAL_NAMESPACE=<namespace>.<account>
export TEMPORAL_API_KEY=<key-secret>
```


### License
Temporal Cloud is a paid service under Temporal's terms, and you keep the rights to the data you send. Temporal itself is open source under the MIT license, free to run on your own servers.

### Good to know
- Temporal Cloud does not run your code. You still run small programs, called workers, on your own servers that do the actual steps.
- Signing up needs a credit card, even for the free $150 credits; local development needs no account.
- You pay per action, such as each step started, timer or message, plus storage, plus 10% of usage for basic support.
- Workflow code must give the same result every time it is replayed; network calls and random values belong in separate steps.
- If you cancel your account, its data is deleted and cannot be restored.

Checked 2026-11-10 against: https://temporal.io, https://temporal.io/pricing, https://temporal.io/pricing.md, https://temporal.io/terms-of-service, https://docs.temporal.io/llms.txt, https://docs.temporal.io/cloud/llms.txt, https://docs.temporal.io/cloud/get-started.md, https://docs.temporal.io/cloud/api-keys.md, https://docs.temporal.io/cloud/pricing.md, https://docs.temporal.io/evaluate/cloud/limits.md, https://docs.temporal.io/evaluate/cloud/regions.md, https://docs.temporal.io/evaluate/cloud/security.md, https://docs.temporal.io/evaluate/use-cases-design-patterns.md, https://docs.temporal.io/develop/python/set-up-your-local-python.md, https://docs.temporal.io/develop/python/client/temporal-client.md, https://docs.temporal.io/develop/python/best-practices/error-handling.md, https://docs.temporal.io/develop/python/integrations/openai-agents.md, https://docs.temporal.io/develop/python/integrations/mcp.md, https://docs.temporal.io/troubleshooting/blob-size-limit-error.md, https://docs.temporal.io/troubleshooting/deadline-exceeded-error.md, https://github.com/temporalio/sdk-python/blob/main/README.md, https://github.com/temporalio/temporal/blob/main/README.md, https://github.com/temporalio/temporal/blob/main/LICENSE, https://pypi.org/pypi/temporalio/1.35.0/json, https://registry.npmjs.org/@temporalio/client/1.25.0

### Mistakes to avoid
- Don't: Calling an outside service, reading the clock or using random values directly inside workflow code. → Do: Put outside calls in Activities and use the workflow module's own helpers inside workflows. (Workflow code is replayed, so anything that changes between runs breaks it and the workflow stops until fixed.)
- Don't: Importing activity modules into the workflow file normally. → Do: Wrap those imports in with workflow.unsafe.imports_passed_through(), as the quickstart does. (Workflows run in a sandbox that re-imports the workflow file on each run.)
- Don't: Passing large files or long texts as workflow inputs or results. → Do: Store the data elsewhere and pass an ID or link. (Each request payload is limited to 2 MB on Temporal Cloud.)
- Don't: Starting workers right after creating a new API key. → Do: First check the key with a simple call (for example temporal workflow list) and retry with backoff, then start workers. (New keys reach the namespace asynchronously and can return Request unauthorized at first.)
- Don't: Letting an Activity retry forever on an error that will never fix itself, such as bad input. → Do: Raise ApplicationError with non_retryable=True for permanent errors. (Otherwise the step keeps retrying until its timeout.)

### Questions
- Is there a free tier? There is no free plan, but new accounts get $150 in credits for 90 days and no base monthly fee. Running Temporal locally or on your own servers is free.
- Does Temporal Cloud see my data? It stores the inputs and results of each step. You can encrypt them on your side first, and then Temporal Cloud cannot read them.
- Which languages can I write workflows in? Go, Java, Python, TypeScript, .NET, PHP, Ruby and Rust, as listed on the pricing page.
- What happens when a step fails? Activities are retried automatically with backoff; you can mark errors that should not be retried so the step fails at once.
- Can my AI assistant read the docs? Yes. Any docs page is available as Markdown by adding .md to its address, with an index at docs.temporal.io/llms.txt.

---
AgentGid's catalog is curated: every entry was checked against the maker's official pages (registry, repository, license and pricing pages) on the date shown; a license value shows the quote it stands on wherever AgentGid has one. Usage numbers come from AgentGid's own scan of public repositories set up for AI coding agents. Claims by makers are reported, not tested by AgentGid.
