• DEPLOYED
  • SYNCED
  • PENDING
  • MANUAL

How to trigger documentation builds with your AI

Connect Mintlify to your AI client once. After that, you can push documentation updates to your live site just by asking.

Ask AI about this page

Short answer

How can I trigger a Mintlify build using my AI?

You tell your AI to deploy your documentation, and it uses the Mintlify MCP to start a new build. This keeps your docs in sync with your code changes immediately. You get a live, updated site without manual CLI commands.

Deployment outcomes.

Where your updates land.

What happens when your AI runs a build command.

DEPLOYED

Live site updates

The trigger_deployment tool starts a build on Mintlify. Your latest documentation changes go live on your hosted URL.

SYNCED

Code and docs aligned

Your AI ensures the documentation matches your current development state. This prevents outdated info from sitting on your site.

PENDING

Build in progress

The AI monitors the request to Mintlify. You'll know when the deployment process has successfully started.

MANUAL

Human review needed

The AI won't guess if a build fails. You'll need to check your Mintlify dashboard if the deployment hits an error.

The workflow

What your AI does when the command arrives.

The AI handles the communication between your chat and the Mintlify platform.

  1. Receive command

    Your AI interprets your request to update or deploy your documentation site.

    trigger_deployment

  2. Initiate build

    The AI sends the deployment signal to Mintlify to start the build process.

    trigger_deployment

  3. Confirm status

    The AI reports back that the deployment request was sent to the Mintlify service.

    trigger_deployment

  4. Handle errors

    If the deployment fails, the AI informs you so you can fix the docs.

    trigger_deployment

Try it

Copy these to start.

Use these prompts to trigger your first build.

Starting points

These are basic requests. You can add specific project names or repository details to make them more precise.

Mintlify Connector

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

Connector linkhttps://edge.vinkius.com/vk_preview_M9aK5cxlba7CD7hPXRmZkQWDWejHvt8xp1tZNLBC/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 — Mintlify capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "mintlify-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_M9aK5cxlba7CD7hPXRmZkQWDWejHvt8xp1tZNLBC/mcp"
    }
  }
}
Copy into chat04

  • Trigger a Mintlify deployment for my current project.

  • Deploy my documentation to Mintlify now.

  • Run a new build for my docs using Mintlify.

  • Can you trigger a deployment for the documentation in this repo?

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

Start here

Connect Mintlify once, then ask.

Click the link to connect your account. Your credentials stay encrypted and secure, and you can start deploying immediately.

Connect Mintlify to your AI

FAQ

How this task behaves.

  • 01

    Can the AI edit my markdown files directly?

    No. This MCP is designed to trigger builds, not to write or edit your source files.

  • 02

    Will the AI deploy my site without my permission?

    No. The AI only triggers a deployment when you explicitly ask it to do so in the chat.

  • 03

    How do I know if the build succeeded?

    The AI will tell you once it has successfully triggered the deployment. You should check your Mintlify dashboard for the final build status.

  • 04

    Can I trigger builds for multiple Mintlify projects?

    Yes, as long as your AI has access to the relevant project configurations through the connection.

  • 05

    Does the AI handle the actual code deployment?

    No. The AI uses the trigger_deployment tool to tell Mintlify to start a build; the actual deployment is handled by Mintlify.

  • More questions about Mintlify? See everything the Mintlify Connector can do

Connect Mintlify to Claude, Cursor, ChatGPT & more