Mintlify

Mintlify is an AI-native intelligent documentation platform designed for the next generation of technical documentation, combining beautiful out-of-the-box design with advanced collaboration and AI capabilities.

Mintlify publishes 5 APIs on the APIs.io network, including Agent API, Analytics API, Assistant API, and 2 more. Tagged areas include Documentation, API Documentation, Developer Portal, Artificial Intelligence, and MCP.

The Mintlify catalog on APIs.io includes 1 Spectral governance ruleset.

Mintlify’s developer surface includes authentication, engineering blog, pricing, documentation, changelog, signup flow, getting-started guide, and 29 more developer resources.

🌐 Visit website 📡 Source on GitHub

50.5/100 developing ▬ flat Agent 35/100 agent ready Front door AI 4/6 moderate saas Full breakdown ↓
scored 2026-09-25 · rubric v0.23.0

AccessFreemiumSelf serve⚡ Free to try

1 APIs

Documentation API Documentation Developer Portal Artificial Intelligence MCP OpenAPI

Kin Score

Kin Score How this is scored →
scored 2026-09-25 · rubric v0.23.0

Composite quality — 50.5/100 · developing

Contract Quality 8.3 / 19

Developer Ergonomics 7.2 / 15

Access Clarity 10.3 / 15

Operational Transparency 5.4 / 10

Contract Governance 0.9 / 9

Discoverability 5.0 / 8

Regulatory Posture 4.2 / 15

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 35/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 5 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 5 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/mintlify: open an issue to ask a question, or submit a pull request to add artifacts. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Mintlify is an area vendor: providers adopt it to run part of their developer surface. This is the Kin Score checks its features can move for a provider that adopts it, what each one really earns, and what it earns nothing for.

documentationmcp hostingmeasured15 features checked 2026-09-25 · rubric v0.22.0

Mintlify’s lift is concentrated in the standalone Agent Readiness layer: a generated skill.md, a conformant A2A agent card and a docs MCP server on every public site, plus llms.txt and an RFC 9727 api-catalog that also move Discoverability. The biggest qualifier is the MCP server: it is one Mintlify template serving docs search, so the rubric grades it platform (a quarter credit), and none of it touches Contract Quality, because Mintlify renders the OpenAPI a provider brings and never writes it. Most of the credit also depends on serving the docs from the provider’s own custom domain rather than a mintlify.app subdomain.

Agent Readiness21.8 of 139 pts

Developer Ergonomics17.0 of 42 pts

Discoverability10.0 of 54 pts

Operational Transparency6.0 of 38 pts

Check	Earns	Through
A2A Agent Card Agent Readiness · customers +0.3 pts vs controlCarries capabilities, protocolVersion, skills and the transport/mode fields, so the harvest grades it conformant; in the catalog 28 of 36 Mintlify-referencing cards graded conformant, the rest near-conformant or flavored. It describes the docs, not the API.	8.0 of 8	A2A agent card per docs site
Agent Skills Agent Readiness · customers +14.0 pts vs controlAuthored by Mintlify’s model from the provider’s docs and served on the provider’s domain, so first-party under rule 2. On a mintlify.app host the same file grades `derived` (0.25); the 2026-09-14 cohort split 59 first-party to 32 derived for exactly that r…	5.0 of 5	Generated skill.md and agent-skills discovery index
Well-Known Catalog Agent Readiness · customers -2.6 pts vs controlDeclare the api-catalog URL as an APICatalog / WellKnown pointer in apis.yml.	4.0 of 4	RFC 9727 api-catalog
MCP Serverplatform Agent Readiness · customers +23.5 pts vs controlOne Mintlify template across the customer base, answering docs search rather than calling the API, so 0.22.0 grades it `platform` (0.25 of 12). The case against the discount is that it runs on the customer’s domain from the customer’s content; that is a rub…	3.0 of 12	Hosted search MCP server
Request/Response Examplespartial Agent Readiness · customers +8.5 pts vs controlThe dimension reads examples inside the OpenAPI first. Mintlify renders what the spec holds, so on its own it reaches only the Examples / Code Samples link fallback.	1.8 of 7	SDK code samples in the reference
Serves a .well-known surface Discoverability · customers -0.9 pts vs controlA real RFC 9727 linkset, but its service-desc links are presigned S3 URLs that expire after an hour, so the catalog points at contracts an agent cannot fetch later. In a 32-provider sample of Mintlify MCP customers, 8 had a 200 api-catalog recorded.	6.0 of 6	RFC 9727 api-catalog
Change log Operational Transparency · customers +7.2 pts vs controlActually keep the changelog page and declare it as a ChangeLog pointer.	6.0 of 6	Changelog pages with RSS
Publishes llms.txt Discoverability · customers +14.8 pts vs controlGenerated, but generated from the provider’s own documentation and served on the provider’s domain, so it reads as the provider’s llms.txt (rule 2’s own-content, own-domain case).	4.0 of 4	Auto-generated llms.txt and llms-full.txt
Documentationsaturated Developer Ergonomics · customers +5.1 pts vs control95% of providers with a contract, docs and a reference already earn this; the vendor cannot move it for most of its buyers.	4.0 of 4	Hosted documentation site and API reference
Developer portal Developer Ergonomics · customers +12.4 pts vs controlDeclare the site as a DeveloperPortal pointer; a docs site alone is a portal only once the provider says so.	4.0 of 4	Hosted documentation site and API reference
Agent Skill Developer Ergonomics · customers +14.0 pts vs controlThe same artifact scored a second time; do not count the work behind it twice.	3.0 of 3	Generated skill.md and agent-skills discovery index
Console or sandbox Developer Ergonomics · customers -4.7 pts vs controlDeclare the playground as a Console / Playground pointer; it is only as live as the servers in the provider’s OpenAPI.	3.0 of 3	Interactive API playground
API referencesaturated Developer Ergonomics · customers +6.0 pts vs control94% of providers with a contract, docs and a reference already earn this; the vendor cannot move it for most of its buyers.	3.0 of 3	Hosted documentation site and API reference

112 detected customers vs 5104 comparable providers: composite 49.4 vs 48.0, agent readiness 37.2 vs 32.4. Association, not cause.

Across 8977 providers that publish a contract, adopting Mintlify would move 8975. Median lift: composite +7.2 (90th percentile +10.1), agent readiness +14.4 (+15.7). Conditional rows excluded.

What Mintlify ships that earns nothing (4)

SDK code samples in the reference — Contract-side examples are counted in the OpenAPI. Mintlify renders the examples a spec already has and writes none back; the +10.9pp measured in 2026-09 was the cohort’s own specs.
Hosted search MCP server — The /.well-known/mcp and server-card documents are none of the four files the check reads (api-catalog, security.txt, protected-resource, AAuth). Only the api-catalog row earns it.
Page feedback from readers and agents — A feedback widget is not a Support, HelpCenter or Community channel.
OAuth protected-resource metadata for authenticated docs — It describes the documentation site’s login, not the API’s resource server. If a probe credits it, that is a false credit the provider did not earn for its API.

4 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Mintlify Rate Limits

3 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Mintlify Finops

FINOPS

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Mintlify API Rules

5 rules · 3 warnings 2 info

SPECTRAL

8 properties

JSON SCHEMA

JSON Structure 1

JSON Structure definitions describing this provider's data shapes.

Mintlify Structure

0 properties

JSON STRUCTURE

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Mintlify Authentication

http · 1 scheme

SECURITY

Mintlify Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Mintlify Vulnerability Disclosure

disclosure policy published

SECURITY

Mintlify Trust Center

SOC 2, ISO 27001

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Mintlify Agentic Access

8 operations · 3 acting

AGENTIC

Resources

Get Started 3

Portal, sign-up, and the first successful call

Signup

Signup

Login

GettingStarted

GettingStarted

Documentation 2

Reference material describing how the API behaves

Guide

Guide

Documentation

Documentation

Agent Surfaces 3

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

AgentSkills

AgentSkills

LlmsText

LlmsText

Build 2

SDKs, sample code, and the tooling you integrate with

PostmanWorkspace

PostmanWorkspace

GitHub

GitHub

Access & Security 6

Authentication, authorization, and security posture

TrustCenter

TrustCenter

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Authentication

Authentication

Security

Security

ResponsibleDisclosure

ResponsibleDisclosure

Learn 1

Tutorials, courses, talks, and written guidance

YouTube

YouTube

Operate 5

Status, limits, changes, and where to get help

ChangeLog

StatusPage

Support

SalesContact

Migration

Commercial 3

Pricing, plans, and the legal terms of use

Pricing

Pricing

PrivacyPolicy

PrivacyPolicy

TermsOfService

TermsOfService

Company 5

The organization behind the API

Website

Website

Blog

Blog

LinkedIn

Twitter

Twitter

Careers

Careers

Other 6

Properties that don't map to a standard resource type

VendorFacets

Customers

Enterprise

Startups

OpenSource

Testimonials

Source (apis.yml)

aid: mintlify
url: https://raw.githubusercontent.com/api-evangelist/mintlify/refs/heads/main/apis.yml
x-docs-platform: mintlify
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-09-17
apis:
- aid: mintlify:mintlify
  name: Mintlify
  tags:
  - Documentation
  humanURL: https://www.mintlify.com/
  properties:
  - url: https://www.mintlify.com/docs/api/introduction
    type: APIReferenceDocumentation
  description: Mintlify is a developer documentation platform that helps product and engineering teams create, maintain, and
    host modern docs. It uses a docs‑as‑code workflow (Markdown in your repo) with a rich component library and GitHub integration.
    Mintlify can generate polished API references from OpenAPI/Swagger or Postman, add interactive “Try it” requests and dynamic
    code samples/SDKs, and includes AI tools (like its Doc Writer) to draft and update docs from your code.
- aid: mintlify:mintlify-agent-api
  name: Mintlify Agent API
  description: Programmatic documentation editing via AI agent jobs.
  humanURL: https://www.mintlify.com/
  tags:
  - Agents
  tags_raw:
  - Agent
  properties:
  - type: OpenAPI
    url: openapi/mintlify-agent-api-openapi.yml
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/update/trigger
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/agent/create-agent-job
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/assistant/create-assistant-message-v2
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/assistant/search
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/introduction
- aid: mintlify:mintlify-analytics-api
  name: Mintlify Analytics API
  description: Export user feedback, conversations, and usage analytics.
  humanURL: https://www.mintlify.com/
  tags:
  - Analytics
  properties:
  - type: OpenAPI
    url: openapi/mintlify-analytics-api-openapi.yml
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/update/trigger
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/agent/create-agent-job
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/assistant/create-assistant-message-v2
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/assistant/search
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/introduction
- aid: mintlify:mintlify-assistant-api
  name: Mintlify Assistant API
  description: Embeddable AI chat experience grounded in your documentation.
  humanURL: https://www.mintlify.com/
  tags:
  - Assistant
  properties:
  - type: OpenAPI
    url: openapi/mintlify-assistant-api-openapi.yml
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/update/trigger
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/agent/create-agent-job
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/assistant/create-assistant-message-v2
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/assistant/search
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/introduction
- aid: mintlify:mintlify-update-api
  name: Mintlify Update API
  description: Trigger and monitor documentation deployment updates.
  humanURL: https://www.mintlify.com/
  tags: []
  tags_raw:
  - Update
  properties:
  - type: OpenAPI
    url: openapi/mintlify-update-api-openapi.yml
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/update/trigger
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/agent/create-agent-job
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/assistant/create-assistant-message-v2
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/assistant/search
  - type: APIReferenceDocumentation
    url: https://www.mintlify.com/docs/api/introduction
name: Mintlify
tags:
- Documentation
- API Documentation
- Developer Portal
- Artificial Intelligence
- MCP
- OpenAPI
kind: contract
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/mintlify.png
access: 3rd-Party
created: '2026-01-05'
modified: '2026-05-30'
position: Consuming
segments:
- Documentation
description: Mintlify is an AI-native intelligent documentation platform designed for the next generation of technical documentation,
  combining beautiful out-of-the-box design with advanced collaboration and AI capabilities.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.23'
common:
- type: VendorFacets
  url: vendor-facets/mintlify-vendor-facets.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/mintlify/overview
- type: AgenticAccess
  url: agentic-access/mintlify-agentic-access.yml
- type: TrustCenter
  url: security/mintlify-trust-center.yml
- type: VulnerabilityDisclosure
  url: security/mintlify-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/mintlify-domain-security.yml
- type: Authentication
  url: authentication/mintlify-authentication.yml
- name: Agent Skills
  url: https://www.mintlify.com/blog/skill-md
  type: AgentSkills
- name: Mintlify - The Intelligent Documentation Platform
  description: 'null'
  url: https://www.mintlify.com/
  type: Website
- name: Customers - Mintlify
  description: 'null'
  url: https://www.mintlify.com/customers
  type: Customers
- name: Blog - Mintlify
  description: 'null'
  url: https://www.mintlify.com/blog
  type: Blog
- name: Pricing - Mintlify
  description: 'null'
  url: https://www.mintlify.com/pricing
  type: Pricing
- name: Introduction - Mintlify Guides
  description: 'null'
  url: https://www.mintlify.com/guides/introduction
  type: Guide
- name: Introduction - Mintlify
  description: 'null'
  url: https://www.mintlify.com/docs/api/introduction
  type: Documentation
- name: Product updates - Mintlify
  description: 'null'
  url: https://www.mintlify.com/docs/changelog
  type: ChangeLog
- name: Sign Up - Mintlify
  description: 'null'
  url: https://dashboard.mintlify.com/signup
  type: Signup
- name: Login - Mintlify
  description: 'null'
  url: https://dashboard.mintlify.com/login
  type: Login
- name: Quickstart - Mintlify
  description: 'null'
  url: https://www.mintlify.com/docs/quickstart
  type: GettingStarted
- name: Status - Mintlify
  description: 'null'
  url: https://status.mintlify.com/
  type: StatusPage
- name: GitHub Organization - Mintlify
  description: 'null'
  url: https://github.com/mintlify
  type: GitHub
- name: LinkedIn - Mintlify
  description: 'null'
  url: https://www.linkedin.com/company/mintlify/posts
  type: LinkedIn
- name: Twitter - Mintlify
  description: 'null'
  url: https://x.com/mintlify
  type: Twitter
- name: Privacy Policy - Mintlify
  description: 'null'
  url: https://www.mintlify.com/legal/privacy
  type: PrivacyPolicy
- name: Terms of Service - Mintlify
  description: 'null'
  url: https://www.mintlify.com/legal/terms
  type: TermsOfService
- name: Security - Mintlify
  description: 'null'
  url: https://security.mintlify.com
  type: Security
- name: Support - Mintlify
  description: 'null'
  url: https://www.mintlify.com/docs/contact-support
  type: Support
- name: Enterprise - Mintlify
  description: 'null'
  url: https://www.mintlify.com/enterprise
  type: Enterprise
- name: Startups - Mintlify
  description: 'null'
  url: https://www.mintlify.com/startups
  type: Startups
- name: Open Source Program - Mintlify
  description: 'null'
  url: https://www.mintlify.com/oss-program
  type: OpenSource
- name: Contact Sales - Mintlify
  description: 'null'
  url: https://www.mintlify.com/contact/sales
  type: SalesContact
- name: Careers - Mintlify
  description: 'null'
  url: https://www.mintlify.com/careers
  type: Careers
- name: Wall of Love - Mintlify
  description: 'null'
  url: https://www.mintlify.com/wall-of-love
  type: Testimonials
- name: Switch to Mintlify
  description: 'null'
  url: https://www.mintlify.com/switch
  type: Migration
- name: Responsible Disclosure - Mintlify
  description: 'null'
  url: https://www.mintlify.com/security/responsible-disclosure
  type: ResponsibleDisclosure
- name: YouTube - Mintlify
  description: 'null'
  url: https://www.youtube.com/@GetMintlify/videos
  type: YouTube
- name: LLMs.txt - Mintlify
  description: 'null'
  url: https://www.mintlify.com/docs/llms.txt
  type: LlmsText

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/mintlify"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/mintlify/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/mintlify/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

Mintlify

What adopting Mintlify moves on the Kin Score 13

APIs 5

Postman Collections 4

Open Collections 6

Pricing Plans 1

Rate Limits 1

FinOps 1

Spectral Rules 1

JSON Schema 6

JSON Structure 1

Security Posture 4

Agentic Access 1

Get Started 3

Documentation 2

Agent Surfaces 3

Build 2

Access & Security 6

Learn 1

Operate 5

Commercial 3

Company 5

Other 6

Source (apis.yml)

MCP server

Tools for providers

Call it yourself

Get an API key