Use Craft’s API to Build With Craft Agents

Use Craft's API to build apps on Craft Agents. Fetch your documents, sync content, and create custom tools powered by your Craft data.

Enabling the API for Documents

First, you have to enable the API in order for Craft to setup an API endpoint for your documents. Then, you use the API endpoint URL to connect to the server from Craft Agents.

Step 1

Open the “Imagine” tab

Step 2

Click “Add Your First API Connection”

Step 3

Configure your API connection with a name.

Step 4

Click “Add Document” to select which documents this API connection has access to.

Step 5

The API URL that will be used to interact with your document is now displayed at the top

Step 6

Click the “Download AI Bundle” button. This will download a folder containing the API documentation and the content of your doc.

Using the API in a Craft Agents Prompt

Once the API is enabled for your Craft docs, you can now focus on writing a prompt that Craft Agents will use to generate your project.

In order for Craft Agents to see how to use the API and understand the structure of your document, you attach the AI bundle to your prompt. This bundle is a markdown document that contains the current content of your Craft doc as well as the API documentation.

Step 1

Open Craft Agents and navigate to Sources in the sidebar. Click "Add Source" or the + button to begin.

Step 2

In the chat input, paste the API endpoint URL. For example: "Connect to https://api.craft.do/...". The agent handles the rest automatically.

Step 3

The agent creates the source configuration, sets up permissions, and validates connectivity with the Craft API.

Step 4

On the Craft authorization page, select the space you want to connect and click "Approve". Your agent is now connected and ready to use.

Some Ideas to Get You Started

Browse App Templates

Personal Blog

Build a personal blog powered by Craft docs. Auto-syncs content via API — publish from your notes app.

Learn more

Reading Log

Track books and capture quotes with Claude or ChatGPT via MCP.

Learn more

Plant Dashboard

A live plant care dashboard built with Lovable. Pulls watering schedules and care tips from your Craft doc.

Learn more