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 API contracts indexed on the APIs.io network, including Agent API, Analytics API, Assistant API, and 2 more. Tagged areas include Documentation, API Documentation, Developer Portal, MCP, and AI Assistant.
The Mintlify catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Mintlify’s developer surface includes CLI, changelog, API reference, authentication, engineering blog, pricing, documentation, and 50 more developer resources.
Kin Score
What adopting Mintlify moves on the Kin Score 13
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.
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.
| 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 |
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.
A model, not a score. Adopting this vendor changes a provider's Kin Score only when the provider publishes the resulting artifacts on its own surface; nothing here writes a score, and no sponsorship or partnership can. The rating is not for sale → · Full vendor facets artifact
Markets this provider is in provisional
The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.
| Market | Position | Depth | Registered MCP server | Declares compatibility |
|---|---|---|---|---|
| Content, Documentation and Design Platforms | builds-on | 15.3 | - | 1 |
| API Management (gateways, portals, service mesh, proxies) | builds-on | 15.3 | - | 1 |
Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards implemented 1
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
APIs 5
Individual APIs this provider publishes, each with its own machine-readable definition.
Mintlify
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...
Mintlify Agent API
Programmatic documentation editing via AI agent jobs.
Mintlify Analytics API
Export user feedback, conversations, and usage analytics.
Mintlify Assistant API
Embeddable AI chat experience grounded in your documentation.
Mintlify Update API
Trigger and monitor documentation deployment updates.
Postman Collections 4
Ready-to-run Postman collections for exercising this provider's APIs.
Mintlify Agent API
POSTMANMintlify Agent Analytics API
POSTMANMintlify Agent Assistant API
POSTMANMintlify Agent Update API
POSTMANOpen Collections 6
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
API Collection
OPEN COLLECTIONMintlify Agent API
OPEN COLLECTIONMintlify Agent Analytics API
OPEN COLLECTIONMintlify Agent Assistant API
OPEN COLLECTIONMintlify Agent Update API
OPEN COLLECTIONMintlify API
OPEN COLLECTIONMCP Servers 1
Model Context Protocol servers that expose these APIs to AI agents.
Pricing Plans 1
Published pricing tiers and plan structures.
Rate Limits 1
Documented rate limits and quota policies.
Mintlify Rate Limits
RATE LIMITSFinOps 1
Cost, billing, and metering signals for API financial operations.
Mintlify Finops
FINOPSSemantic Vocabularies 1
JSON-LD contexts and semantic vocabularies used across these APIs.
Mintlify Context
JSON-LDSpectral Rules 2
Spectral governance rulesets for linting and validating these APIs.
Mintlify — jsonschema rules
SPECTRALMintlify API Rules
SPECTRALJSON Schema 12
Standalone JSON Schema definitions for this provider's data models.
AgentJobRequest
JSON SCHEMAAgentJob
JSON SCHEMAAgentJob
JSON SCHEMAAgentJobRequest
JSON SCHEMAAssistantMessageRequest
JSON SCHEMAAssistantMessageRequest
JSON SCHEMASearchRequest
JSON SCHEMASearchResult
JSON SCHEMASearchRequest
JSON SCHEMASearchResult
JSON SCHEMAUpdateStatus
JSON SCHEMAUpdateStatus
JSON SCHEMAScroll for all 12
JSON Structure 1
JSON Structure definitions describing this provider's data shapes.
Mintlify Structure
JSON STRUCTURESecurity Posture 4
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Agentic Access 1
Recommended x-agentic-access execution contracts for AI agents.
Resources
Get Started 3
Portal, sign-up, and the first successful call
Documentation 3
Reference material describing how the API behaves
Agent Surfaces 7
MCP servers, agent skills, and machine-readable catalogs
Scroll for all 7
Design & Contract 6
Pagination, idempotency, versioning, errors, and events
Build 3
SDKs, sample code, and the tooling you integrate with
Access & Security 7
Authentication, authorization, and security posture
Scroll for all 7
Learn 1
Tutorials, courses, talks, and written guidance
Operate 8
Status, limits, changes, and where to get help
Scroll for all 8
Commercial 5
Pricing, plans, and the legal terms of use
Company 5
The organization behind the API
Other 9
Properties that don't map to a standard resource type
Scroll for all 9
Source (apis.yml)
Work with this as data
Every provider here is available over the APIs.io API and to AI agents over MCP.