> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kadoa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create workflows from your AI tool

> Ask Claude, ChatGPT, or Cursor to create Kadoa workflows over MCP

Ask your AI tool for the data you need. It calls Kadoa's MCP tools, and Kadoa's agent builds the workflow.

## Before you begin

* Your AI tool connected to Kadoa. See [Connect your AI tool](https://docs.kadoa.com/docs/sdk/mcp.md). The hosted server uses OAuth, so you need no API key.
* Members, Admins, and Owners approve previews in the dashboard. See [Preview and approval](https://docs.kadoa.com/docs/ui/workflows/human-in-the-loop.md).

## Choose the source

One workflow covers one website. See the [source rules](https://docs.kadoa.com/docs/ui/workflows/sources.md#source-rules).

Include the URL in your request, for example:

```text theme={null}
> "Get me all job postings from https://sandbox.kadoa.com/careers"
```

Your AI tool passes the URL to `create_workflow`.

## Write the prompt

A prompt drives every workflow. It describes in plain language what to extract and how to get there. The agent follows it on its own and handles navigation, pagination, clicks, forms, and file downloads. For multi-step extractions, write clear steps in order. See [Prompts](https://docs.kadoa.com/docs/workflows/prompts.md#writing-good-prompts) for patterns that work.

Ask your AI tool, for example:

```text theme={null}
> "Extract all products from https://sandbox.kadoa.com/ecommerce including title, price, description, and specs. Navigate through pagination and open detail pages."
```

Your AI tool calls `create_workflow` with your request as the prompt.

## Auto-detect fields

Give Kadoa a source without naming fields. Kadoa suggests a data schema and extracts all relevant data from the page.

Ask your AI tool, for example:

```text theme={null}
> "Extract all products from https://sandbox.kadoa.com/ecommerce"
```

Your AI tool calls `create_workflow`.

## Define the fields

Name each field yourself for precise control over the output.

Name the fields in your request, for example:

```text theme={null}
> "Extract product title, price in USD, availability, rating, and release date from https://sandbox.kadoa.com/ecommerce"
```

Your AI tool passes the fields to `create_workflow` as a schema.

## Limit the rows per run

A row limit caps how many records each run extracts. Without one, the workflow extracts all rows.

Ask your AI tool, for example:

```text theme={null}
> "Extract the first 50 products from https://sandbox.kadoa.com/ecommerce"
```

`create_workflow` takes `limit`, the maximum records to extract per run. To remove a limit later, your AI tool calls `update_workflow` with `limit` set to `null`.

## Schedule the workflow

A new workflow runs once unless you give it a schedule.

Ask your AI tool, for example:

```text theme={null}
> "Extract all products from https://sandbox.kadoa.com/ecommerce every day"
```

`create_workflow` takes `updateInterval`, which defaults to `ONLY_ONCE`, and cron expressions in `schedules`.

See [Scheduling](https://docs.kadoa.com/docs/workflows/scheduling.md) for every interval, cron examples, and timezones.

## Create from a template

If your team has [templates](https://docs.kadoa.com/docs/templates.md), start the workflow from one. The schema, data quality rules, notifications, frequency, and record limit come from the template. The workflow links to the template's latest version, and the template-managed parts become read-only on the workflow.

You can still add instructions for this source. Kadoa keeps them separate from the template's setup prompt, so later template updates do not overwrite them.

Ask your AI tool, for example:

```text theme={null}
> "Create a workflow from the 'Job Listing' template for https://example.com/careers"
```

Your AI tool calls `create_workflow` with `templateId`. Without `templateVersion`, it uses the latest published version. The prompt then holds only instructions specific to this workflow.

## Related

* [MCP tools](https://docs.kadoa.com/docs/sdk/mcp-tools.md): every tool and its parameters.
* [Work with the agent](https://docs.kadoa.com/docs/workflows/agent.md): change a workflow or answer the agent's questions.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.