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

# Pipeline tools

> MCP tools that run the AiQL pipeline steps

The pipeline tools mirror the API tools. An agent can call them individually or chain them as `convert → split → shape → extract`.

## convert

Converts any URL into clean markdown.

| Parameter | Type     | Description                                                                                               |
| --------- | -------- | --------------------------------------------------------------------------------------------------------- |
| `url`     | `string` | URL of the source to convert. A file URL of any extension, a web page, a YouTube video, or any other URL. |

Returns the normalized markdown. See the [Convert cookbook](/cookbooks/convert) for details.

## split

Breaks markdown content into smaller chunks that the later steps can process reliably.

| Parameter  | Type     | Description                |
| ---------- | -------- | -------------------------- |
| `markdown` | `string` | Markdown content to split. |

Returns an ordered list of chunks. See the [Split cookbook](/cookbooks/split) for details.

## shape

Inspects markdown content and infers a schema of the data it contains.

| Parameter  | Type     | Description                              |
| ---------- | -------- | ---------------------------------------- |
| `markdown` | `string` | Markdown content to infer a schema from. |

Returns a schema of `classes`, `properties`, and `relationships`. See the [Shape cookbook](/cookbooks/shape) for details.

## extract

Pulls structured values out of markdown content according to a schema.

| Parameter  | Type     | Description                                                          |
| ---------- | -------- | -------------------------------------------------------------------- |
| `markdown` | `string` | Markdown content to extract from.                                    |
| `schema`   | `object` | Schema with `classes`, `properties`, and `relationships` to extract. |

Returns a graph of `nodes` and `relationships`. See the [Extract cookbook](/cookbooks/extract) for details.

<Note>
  Tools called over MCP are billed the same as the equivalent API tools. See [Pricing](/pricing) for credit rates.
</Note>