Denzell Ford
Engineering
Share this article
Denzell Ford
Engineering
Share this article
Ask Claude Code, Cursor, or Codex to document a repository and it can write the pages in minutes. Ask it to put them online, and until now, the agent eventually handed the job back to you.
In our evals, agents built the site locally, reached signup, then told the user to finish the flow in a browser. Email verification and GitHub setup were human-only steps.
mint deploy removes that handoff. An agent can publish a live Mintlify site from the terminal without an account or GitHub repository, then send you a link to claim the site within 24 hours.
From prompt to live docs #
From the folder that holds docs.json, the agent runs:
npm i -g mint
mint deploy --subdomain acme
The CLI creates a Mintlify-hosted Git repository and returns a short-lived write token. The agent pushes your docs, and the site goes live at acme.mintlify.site.
You do not need to create an account or connect GitHub before the first deployment.
Deploy with or without GitHub #
The default flow gives the agent a Mintlify-hosted repository. If you want your docs to live in an existing GitHub repository, use:
mint deploy --github --subdomain acme
This writes a GitHub Actions workflow that updates the site when you push to the default branch. If your docs live in a subdirectory, pass it with --directory.
Claim the site within 24 hours #
The site is already live when the claim flow begins. Claiming moves it into your Mintlify dashboard so you can keep managing it.
- The agent needs your email to run
mint claim --email jane@acme.com. - You open the claim link and sign in or create an account.
- You copy the code on the page and paste it back to the agent.
- The agent completes the claim with
mint claim --code 4F7K-9QX2.
Claiming makes you an admin of the site's organization.
Try it with your agent #
Open Claude Code, Cursor, or Codex in the folder that contains docs.json and paste this prompt:
Install the Mintlify CLI with npm i -g mint, then publish the docs in this folder with mint deploy. Push the files, check that the site loads, and send me the live URL. Remind me to claim the site within 24 hours.
Run mint deploy --help to see every option, or read the agent signup docs.
If you have any other ideas to improve your agentic workflow, add them to the roadmap.
Frequently Asked Questions #
How does an agent know what to do?
Agents can discover the flow through mintlify.com/auth.md. auth.md is an open protocol from WorkOS that explains how an agent can register with a service and hand the resulting account to a person.
Mintlify's file describes the same flow as raw HTTP requests, so agents that cannot install the CLI can still register, provision a site, and hand it to you through the claim page.
Which agents does this work with?
Any agent that can run shell commands, npm, and Git, including Claude Code, Cursor, and Codex.
What does it cost?
Deploying is free. If this is your first Mintlify site, claiming it starts a Pro trial.
What happens if I do not claim the site?
It expires 24 hours after creation and is deleted, along with its hosted repository. To start over, run mint deploy --new --subdomain <name> to create a new site.
What if I already have a Mintlify account?
Sign in with your existing account and the site will appear in your dashboard. If you belong to several organizations, the claim page may ask you to choose one.
Can I move a claimed site to my own GitHub repository?
Yes. After you claim a site, open the Git settings in your dashboard and connect your repository. mint deploy --github only works for sites that have not been claimed yet.
More blog posts to read
Self-updating external docs is an infinite market
Product surface areas are growing exponentially, agents are becoming the main users of docs, and external agents can't read your primary sources. Together, these make self-updating external docs an infinite market.
October 25, 2026 Patrick Foster
Software Engineer
Bring your own skills to the Mintlify agent
You can now upload custom skills to the agent in the web editor. Give it your style guide, review checklist, or page templates once, and it uses them whenever a task calls for them.
October 23, 2026 David Isquick
Product Marketing