Docs for Agents

A reference index of every machine-readable endpoint, format, and tool for connecting AI agents and LLMs to Kestra.

MCP server

The Kestra MCP server gives AI tools live access to plugin documentation, blueprints, and product docs. Configure it in Claude Code, Cursor, or any MCP-compatible agent.

Auto-discovery endpoint:

https://kestra.io/.well-known/mcp.json

Server URL:

https://api.kestra.io/v1/mcp

No authentication required for the public server. See the MCP server setup guide for configuration instructions for each tool.

Agent Skills

Agent Skills are structured knowledge files that teach AI coding agents how to generate valid Kestra flows, harden them for production, and operate Kestra environments via the CLI.

Install all Kestra skills with:

npx skills add kestra-io/agent-skills

Available skills: kestra-flow, kestra-flow-hardening, kestra-ops, migrate-airflow-kestra.

See the Agent Skills page for full descriptions and example prompts.

Plain Markdown docs

Every Kestra documentation page is available as plain Markdown. Three ways to retrieve it:

• Copy Page menu — every docs page has a toolbar with Copy as Markdown, View as Markdown, Open in ChatGPT, and Open in Claude.

• Append .md to any kestra.io/docs/* URL:

  https://kestra.io/docs/quickstart.md

• Set the Accept header on the request:

  curl -H "Accept: text/markdown" https://kestra.io/docs/quickstart

This works for all docs pages, including versioned docs such as kestra.io/docs/1.3/quickstart.md.

llms.txt endpoints

The llms.txt file follows the llms.txt standard and includes the MCP server discovery URL.

Plugin and flow schemas

The flow schema is the same schema used by Kestra’s AI Copilot. Pass it to your agent to validate flow YAML before deploying.

OpenAPI specs

Kestra’s REST API is described by an OpenAPI specification. Use it to generate clients or give an agent a complete picture of available endpoints.

The interactive API reference at /docs/api-reference is rendered from these same spec files.