• SEARCH
  • DETAILS
  • STATUS
  • HUMAN

How to query workflow status with your AI

Connect Temporal to your AI client to search your namespace using plain English. You can find specific executions and check their status without writing complex query syntax.

Ask AI about this page

Short answer

Can I ask my AI to find specific Temporal workflows?

Yes. Your agent uses natural language to filter and locate executions across your namespace. You'll get specific details on status and custom attributes through a single chat prompt. Here is how the data flows.

Query outcomes.

Where your searches lead.

The AI translates your questions into specific Temporal visibility queries.

SEARCH

Filtered execution lists

The AI finds specific workflows based on your description. You get a list of matching executions immediately.

DETAILS

Attribute inspection

Your agent pulls specific search attributes for a workflow. This helps you verify custom metadata without manual lookups.

STATUS

Real-time state

Get the current state of any running or completed workflow. The AI identifies if things are running, failed, or timed out.

HUMAN

Manual intervention

The AI identifies issues but won't touch the workflow state. You still handle any necessary restarts or terminations.

The workflow

What your AI does when the request arrives.

The AI acts as a bridge between your chat interface and the Temporal engine.

  1. Identify attributes

    The AI checks which search attributes are available in your namespace to understand what it can filter by.

    list_search_attributes

  2. Find workflows

    The AI uses your description to run a visibility query and find matching executions.

    search_workflows

  3. List executions

    If you ask for a general overview, the AI pulls a list of workflows from the namespace.

    list_workflows

  4. Report status

    The AI summarizes the findings, including the current state of the requested workflows.

    search_workflows

Try it

Copy these to start.

Use these prompts to test the connection.

Starting points

These are opening lines. Swap out the specific IDs or attribute names for your own.

Temporal Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_EnU6gjOxc9KSHxcvKKIpGvDNCsHHJOBTVxTch47l/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Temporal capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "temporal-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_EnU6gjOxc9KSHxcvKKIpGvDNCsHHJOBTVxTch47l/mcp"
    }
  }
}
Copy into chat04

  • Find all workflows in my namespace that are currently running.

  • Show me the status of the workflow with ID order-7742.

  • List all completed workflows that have the 'customer_id' attribute set to 'user_99'.

  • Which workflows are currently in a failed state?

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Temporal once, then ask.

Just link your Temporal account. Your credentials stay encrypted, and you can start querying immediately from your preferred AI client.

Connect Temporal to your AI

FAQ

How the Temporal Connector behaves.

  • 01

    Can the AI terminate a workflow for me?

    No. The current tools only allow the AI to search and list workflows. You must manually terminate or signal workflows through your own Temporal tools.

  • 02

    Can I search by custom attributes?

    Yes. If your workflows have search attributes defined, the AI can use them to filter results.

  • 03

    Does the AI see my entire Temporal cluster?

    The AI only sees what is within the namespace you provide during connection.

  • 04

    Can the AI change the input of a running workflow?

    No. The AI is limited to visibility and search actions. It cannot send signals or modify execution state.

  • 05

    How does the AI know which attributes are available?

    The AI uses the available search attribute tools to understand what metadata it can filter by.

  • More questions about Temporal? The Connector page answers them. See everything the Temporal Connector can do

Connect Temporal to Claude, Cursor, ChatGPT & more