# Mintlify startup deal: 6 months free Startup

> Beautiful API documentation, auto-generated from code with MDX, interactive examples, and analytics.

- **Offer:** 6 months free Startup
- **Save up to:** $500
- **Category:** Developer & IT
- **How to get it:** Claim details are unlocked with SaaSOffers Premium. https://saasoffers.tech/offers/mintlify
- **Eligibility:** API-first startup

## What you get

- 6 months of Mintlify Startup
- MDX-based documentation
- Auto-generated API reference
- Built-in search
- Documentation analytics

## Our Mintlify listing: 6 months free Startup

**Offer:** 6 months free Startup. Our listing's requirement is "API-first startup". There is no promo code. The listing links to Mintlify's own startup page at mintlify.com/startups, so step 1 is a visit to Mintlify's site, not a SaaSOffers redemption page.

![Mintlify homepage, 6 months free Startup for startups](https://zlcbkfmbwwroglopnrhf.supabase.co/storage/v1/object/public/blog-images/deals/mintlify/tool1.png)

We checked these plans and prices against Mintlify's official pricing and help pages in November 2026.

Mintlify's pricing page lists three plans: Starter, Pro and Enterprise. There is no plan called "Startup" and no plan called "Hobby". The startup page we link to describes a different program from our listing's wording. Mintlify says qualifying startups get Pro at half price for 12 months, and current Y Combinator companies get 12 months free. It does not mention six free months. So "6 months free Startup" is our listing's term. We could not confirm it on Mintlify's site, and the worked examples below treat it as "if it applies".

Mintlify is a documentation platform. You keep Markdown and MDX files in a Git repository, add an OpenAPI file, and Mintlify builds a hosted docs site with an interactive API playground, search, an AI assistant and analytics.

## The startup program on Mintlify's own page

Mintlify's startup page names two groups: venture-backed startups and YC alumni. It gives these terms:

- Startups founded in the past 2 years that have raised under $2M get Pro at half price, plus priority support.
- Your startup must never have been on a paid Mintlify plan.
- Standard startups get 50% off Pro for 12 months.
- YC alumni get 50% off for 12 months.
- The current YC batch gets 12 months free.
- You apply through a form linked from the page.

The page does not say how long review takes, what counts as approval, or whether the discount appears as a credit or a percentage on invoices. It also does not say which Pro rate the 50% applies to, yearly or monthly.

Our requirement is "API-first startup". Mintlify's own requirements are about age and funding: under 2 years old, under $2M raised, never paid before. An API-first company that is 3 years old or has raised more would not meet Mintlify's stated terms, whatever our listing says. Check both before you apply.

## Starter is free and includes 5 editor seats

Mintlify's pricing page shows Starter at $0 a month with 5 editor seats. It lists these Starter features:

- Full platform and a web editor
- Custom domain
- Mintlify authentication
- MCP server
- API playground and search
- Git sync
- Custom components, custom CSS and JS
- SEO and GEO optimizations

So a team of up to five editors can publish a branded API reference on a custom domain without paying. You do not need a startup offer to try that.

## Pro: $450 a month billed yearly, $540 billed monthly

![Mintlify plans and features before the 6 months free Startup deal](https://zlcbkfmbwwroglopnrhf.supabase.co/storage/v1/object/public/blog-images/deals/mintlify/tool2.png)

| Plan | Billed yearly | Billed monthly | Key limits |
|---|---|---|---|
| Starter | $0 | $0 | 5 editor seats, no credits listed |
| Pro | $450/month ($5,400/year) | $540/month ($6,480/year) | Unlimited editor seats, 10,000 credits a month |
| Enterprise | Contact sales | Contact sales | Unlimited seats, custom credits, volume discounts |

The pricing page reads "$450/mo billed annually, or $540/mo billed monthly". The yearly totals are our math: $450 x 12 = $5,400 and $540 x 12 = $6,480. Paying monthly costs $90 a month more, or $1,080 a year. That is a 20% premium over the annual rate ($90 / $450), or put the other way, annual billing is 16.7% below the monthly price ($90 / $540).

Pro includes everything in Starter plus:

- Agent, assistant and Autopilot
- Preview deployments
- Admin APIs and a developer API
- WebMCP
- User feedback
- Webhooks and websockets
- Platform and agent analytics
- Password authentication
- Grammar and spelling checks
- Narration and AI translations
- Support integrations and agent skills
- An unlimited writing agent

## What Starter lacks

If you stay on Starter, you give up the Pro list above. In practice the gaps that hurt an API company are these:

- No assistant, so readers cannot ask questions of your docs.
- No analytics on what developers search for or where they stop.
- No preview deployments, so you cannot review a docs change on a live URL before it ships.
- No password authentication, so private docs for design partners are out.
- No webhooks or developer API for wiring docs into your release process.

Enterprise adds SSO, OAuth and JWT sign-in, SCIM, role-based access control, audit logs, PDF export, white labeling, self-hosting, EU hosting and migration services.

## Credits: the meter that is easy to miss

Pro bills AI work in credits. Mintlify's assistant page says every Pro plan contributes 10,000 credits a month to your organization's shared balance. The assistant, the agent and Autopilot all draw from it.

The pricing page sets these costs:

- Assistant: 25 credits per answer, and no charge if it cannot answer.
- Autopilot: 250 credits per update, and no charge if nothing needs updating.
- Writing agent: unlimited on Pro and Enterprise at no charge.
- Overage on Pro: $0.01 per credit.

Do the math. 10,000 credits cover 400 assistant answers (10,000 / 25), or 40 Autopilot updates (10,000 / 250), or a mix. A single extra assistant answer past the allowance costs 25 x $0.01 = $0.25. An extra Autopilot update costs 250 x $0.01 = $2.50. If readers ask 1,000 more questions than the allowance covers, that is 25,000 credits, or $250.

You can set a hard spending limit or turn overages off in the dashboard. Credit packs exist at discounted rates, but the pricing page does not list their prices. For a young API with a few hundred readers, 400 answers a month may be enough. For a popular one, plan for the meter.

## The 14-day Pro trial

Mintlify offers Pro free for 14 days with 5,000 credits and no credit card. The trial ends after 14 days or when the 5,000 credits run out, whichever comes first. Afterward you can upgrade or stay on Starter.

5,000 credits is 200 assistant answers (5,000 / 25). That is enough to test the assistant on your own docs. It is not enough to judge how real traffic will use it.

## Pricing by team size and usage

Mintlify prices Pro as a flat fee with unlimited editor seats. That changes the math as a team grows.

**5-person team.** Starter has 5 editor seats, so it costs $0. Pro costs $450 a month ($5,400 a year) or $540 a month ($6,480 a year). With our listing's six free months, if it applies to the yearly rate, six months saves 6 x $450 = $2,700 and the first year costs $5,400 - $2,700 = $2,700. Under Mintlify's own program, 50% off for 12 months at the yearly rate is $225 a month, or $2,700 for the year. Both routes come to $2,700 in year one if the discount applies to the $450 rate. If the 50% applied to the monthly rate, the saving would be $270 x 12 = $3,240. Mintlify's page does not say which.

**10-person team.** Pro stays at $450 a month yearly, because seats are not billed. The year is still $5,400 before any offer. Starter would not cover this team, since it has 5 editor seats.

**Heavy assistant use.** Add 1,000 extra assistant answers a month on Pro: $250 in overage. At the yearly rate, that month costs $450 + $250 = $700. If that pattern holds for 12 months, the overage alone is $3,000, which could be more than a startup discount saves. Watch usage before assuming the plan fee is the whole bill.

## Building the API reference from OpenAPI

Mintlify's OpenAPI setup page says it supports OpenAPI 3.0, 3.1 and 3.2 documents. Specs must be JSON or YAML. Only internal $ref references work, so external references are not supported.

You add an `openapi` field to a navigation tab or group in `docs.json`, for example `"openapi": "openapi.json"`. You can list several specs in an array. Each spec can be a path in the repo or a hosted URL, and production URLs must use HTTPS.

If you set `openapi` and list no other pages, every endpoint in the spec gets a page. To pick endpoints, list entries such as `GET /users`. Webhook pages need OpenAPI 3.1 or later. You can hide an endpoint with `x-hidden`.

The playground needs a `servers` field with your base URL. Without it, the playground uses simple mode. Authentication comes from `securitySchemes` and `security`, and the `x-default` extension prefills API key and bearer values. Mintlify also supports Overlay Specification versions 1.0 and 1.1, which lets you change how a spec displays without editing the source file.

## Setup: CLI, Git and deploys

The quickstart says the CLI needs Node.js v20.17.0 or higher. Install it with `npm i -g mint` or `pnpm add -g mint`. Run `mint dev` in your docs directory and open `http://localhost:3000` for a local preview.

Docs live in a Git repository where each page is a file. Pushing to the repository triggers a deploy, and you check status on the dashboard's Overview page. Without an account you can run `mint deploy --subdomain <name>` and then `mint claim`. The page says an unclaimed site expires.

## What the assistant does and does not do

The assistant is available on Pro and above. Mintlify says it:

- Searches your docs and retrieves content as Markdown
- Uses the page the reader is on as context
- Cites sources with links
- Returns API details such as methods, parameters, request bodies and response schemas from your OpenAPI specs
- Generates copyable code examples
- Accepts text, images and other files from the user

It answers only from your documentation. If it finds nothing relevant, it says it does not have enough information. You can set a deflection email so users see your support address in that case. Hidden pages are not indexed unless you set `seo.indexing` to `"all"`, and draft branches and preview deployments are not indexed. Published changes, including deletions, are indexed immediately.

## MCP and agents as readers

Mintlify generates a search MCP server for each site at the `/mcp` path. Its own docs use `https://mintlify.com/docs/mcp`. If authentication is on, the authenticated server is at `/authed/mcp`, and results are limited to content the user's groups can see. The server exposes three tools: Search, Query docs filesystem and Submit feedback.

Discovery files are served at `/.well-known/mcp` and related paths with no configuration. WebMCP requires Pro or Enterprise. A hosted MCP server lets a coding agent search your reference directly.

## Mintlify against ReadMe and GitBook

| Tool | Free tier | Paid entry (yearly billing) | Seat model |
|---|---|---|---|
| Mintlify | Starter, $0, 5 editor seats | Pro $450/month | Unlimited editor seats on Pro |
| [ReadMe](/offers/readme) | Starter, $0, 1 admin | Pro $250/month | 5 admins included, $20 each extra |
| [GitBook](/offers/gitbook) | Free, $0, 1 user | Essential $65 per site/month | $12 per user/month |

The ReadMe figures come from ReadMe's own pricing page, and the GitBook figures from GitBook's pricing page, which says its site prices apply when billed annually. GitBook's page does not list month-to-month rates.

Yearly cost for a 5-person team, one site, entry paid tier:

- Mintlify Pro: $450 x 12 = $5,400.
- ReadMe Pro: $250 x 12 = $3,000.
- GitBook Essential: ($65 + 5 x $12) x 12 = $125 x 12 = $1,500.

For a 10-person team:

- Mintlify Pro: $5,400.
- ReadMe Pro: ($250 + 5 extra admins x $20) x 12 = $350 x 12 = $4,200.
- GitBook Essential: ($65 + 10 x $12) x 12 = $185 x 12 = $2,220.

On those numbers Mintlify Pro costs more than the other two entry tiers at both sizes. The plans are not equal: GitBook Essential includes $20 of AI credits, and Mintlify's price buys the agent, Autopilot and the analytics listed above. Price is not the only axis.

## Who Mintlify is for
- An API company with an OpenAPI file, a Git workflow and at least one engineer who will own the docs.
- A team that wants an AI assistant answering from its own reference, and can live with a credit meter.
- A startup under 2 years old with under $2M raised, which fits Mintlify's own program.
- A company in the current YC batch (12 months free) or a YC alum (50% off for 12 months).

## Who Mintlify is not for
- A solo founder with one API and no need for an assistant. Starter at $0 may be all you need.
- A company older than 2 years or past $2M raised, which does not meet Mintlify's stated startup terms.
- A team that wants flat, predictable bills. Credits are metered, with $0.01 overage per credit.
- A buyer comparing on entry price alone. On the figures above, ReadMe Pro and GitBook Essential are cheaper at 5 and 10 people.

## Claiming the Mintlify offer, step by step
1. Go to mintlify.com/startups.
2. Read the eligibility terms: under 2 years old, under $2M raised, never on a paid Mintlify plan.
3. Open the application form linked on that page and submit it.
4. Ask Mintlify to confirm in writing what you get. Our listing says 6 months free, while Mintlify's page says 50% off Pro for 12 months, or 12 months free for the current YC batch.
5. If you are not approved, start on Starter or use the 14-day Pro trial.

There is no promo code and no SaaSOffers link for this listing.

## Setup tips for the first month

- Export your OpenAPI file first and fix any external $ref entries, since only internal references work.
- Add a `servers` field, or the playground falls back to simple mode.
- Set a spending limit or turn off overages the day you move to Pro.
- Preview changes with `mint dev` before pushing.
- Decide whether hidden pages should be searchable, because `seo.indexing` defaults to navigation pages only.

## FAQ

### Is Mintlify free?

Yes, the Starter plan is $0 a month and includes 5 editor seats, a custom domain, the API playground, search, Git sync and an MCP server. Pro is $450 a month billed yearly or $540 billed monthly.

### Does Mintlify offer 6 months free for startups?

We could not confirm that on Mintlify's site. Its startup page says qualifying startups get 50% off Pro for 12 months, and the current YC batch gets 12 months free. The six months is our listing's term, so confirm it with Mintlify when you apply.

### Who qualifies for Mintlify's startup program?

Mintlify's page says startups founded in the past 2 years that have raised under $2M, and that have never been on a paid Mintlify plan. YC alumni get 50% off for 12 months and the current YC batch gets 12 months free.

### How much does the Mintlify assistant cost to run?

Pro includes 10,000 credits a month. The assistant uses 25 credits per answer, so that is 400 answers. Overage on Pro is $0.01 per credit, or $0.25 per extra answer. You can set a hard spending limit.

### Which OpenAPI versions does Mintlify support?

OpenAPI 3.0, 3.1 and 3.2 in JSON or YAML. Only internal $ref references work, and the playground needs a servers field or it falls back to simple mode.

### Is there a Mintlify trial?

Yes. Pro is free for 14 days with 5,000 credits and no credit card. The trial ends after 14 days or when the credits run out. Afterward you can upgrade or stay on Starter.

---
Source: SaaSOffers, https://saasoffers.tech/offers/mintlify
