Knowledge Management · Beta

Mintlify
API integration

Ship Knowledge Management features without building the integration. Full Mintlify API access via Proxy and 10+ MCP-ready tools for AI agents — extend models and mappings to fit your product.

Built for specific customer use cases. Issues are resolved quickly.

Talk to us

Use Cases

Why integrate with Mintlify

Common scenarios for SaaS companies building Mintlify integrations for their customers.

01

Attach AI chat transcripts to support tickets

Helpdesk and ticketing platforms can pull Mintlify Assistant conversations into new tickets so human agents inherit full context of what the user already asked the AI, eliminating repetition and cutting time-to-resolution.

02

Post live doc previews on pull requests

CI/CD and developer workflow platforms can trigger Mintlify preview builds against feature branches and surface rendered preview URLs inside the PR review experience, so reviewers approve code and docs together.

03

Turn doc telemetry into product insights

Product analytics and PM platforms can join Mintlify page views, search queries, and per-page feedback with in-app usage data to surface knowledge gaps, failed searches, and friction points worth prioritizing on the roadmap.

04

Ground in-app copilots in customer docs

AI-first SaaS products can query a customer's Mintlify index and fetch structured page content at runtime to inject up-to-date documentation into their own copilot's prompt context, reducing hallucinations on technical questions.

05

Automate docs maintenance with agent jobs

Engineering productivity and DevRel tools can dispatch Mintlify agent jobs to draft updates, then publish via project updates — letting customers wire doc maintenance directly into their existing workflows.

What You Can Build

Ship these features with Truto + Mintlify

Concrete product features your team can ship faster by leveraging Truto’s Mintlify integration instead of building from scratch.

01

AI conversation handoff to tickets

Sync Mintlify Assistant conversations and caller stats into a support ticket so agents see the full AI transcript on the first reply.

02

PR-triggered documentation previews

Create a Mintlify project preview per branch, poll its status, and post the preview URL back as a PR comment for inline review.

03

Docs analytics dashboards

Ingest page views, unique visitors, search queries, and per-page feedback into your analytics product to visualize documentation engagement and ROI.

04

Zero-result search alerting

Stream Mintlify search queries into your platform and alert PMs or writers when high-volume terms return no results, exposing real content gaps.

05

Doc-grounded in-app AI copilot

Run documentation searches and pull structured page content on demand to augment your own AI assistant with the customer's latest Mintlify docs.

06

One-click production publishing

Let users trigger a Mintlify project update from inside your product and track build status through completion without leaving the workflow.

SuperAI

Mintlify AI agent tools

Comprehensive AI agent toolset with fine-grained control. Integrates with MCP clients like Cursor and Claude, or frameworks like LangChain.

create_a_mintlify_project_update

Queue a deployment update for a Mintlify documentation project from its configured deployment branch. Returns statusId that can be used to track update progress.

get_single_mintlify_project_update_status_by_id

Get the status of a triggered project update in mintlify by its status ID. Returns: status (queued, in_progress, success, failure), projectId, summary, and logs. Required: id.

create_a_mintlify_project_preview

Create or update a preview deployment for a specific branch in mintlify. Returns: statusId (for tracking progress) and previewUrl. Required: branch.

create_a_mintlify_agent_job

Create an agent job in mintlify for a specific project.

get_single_mintlify_agent_job_by_id

Get a mintlify agent job by id within a specific project. Required: id.

create_a_mintlify_agent_job_message

Create a message for a Mintlify agent job. Required: job_id.

list_all_mintlify_feedback

List feedback entries from Mintlify analytics for a given project. Returns an array of feedback records from the analytics data.

list_all_mintlify_feedback_by_page

List feedback aggregated by page for a Mintlify project. Returns feedback data grouped per page from the analytics dataset.

list_all_mintlify_assistant_conversations

List assistant conversations for a Mintlify project. Returns conversation data from the analytics assistant endpoint.

list_all_mintlify_assistant_caller_stats

List assistant caller statistics for a Mintlify project. Returns analytics data about assistant callers associated with the specified project.

list_all_mintlify_search_queries

List search queries recorded in mintlify analytics for a given project. Returns search query data from the analytics dataset.

list_all_mintlify_page_views

List page view analytics for a mintlify project. Returns an array of page view records from the analytics data.

list_all_mintlify_unique_visitors

List unique visitors analytics for a Mintlify project. Returns visitor data from the analytics endpoint.

create_a_mintlify_assistant_message

Send a message to the Mintlify assistant for a specific domain. Required: `domain`.

list_all_mintlify_documentation_searches

Search Mintlify documentation for a given domain. Returns matching documentation results for the specified domain. Required: domain.

get_single_mintlify_page_content_by_id

Get page content from Mintlify via the discovery API for a given domain. Required: domain.

Why Truto

Why use Truto’s MCP server for Mintlify

Other MCP servers give you a static tool list for one app. Truto gives you a managed, multi-tenant MCP infrastructure across 500+ integrations.

01

Auto-generated, always up to date

Tools are dynamically generated from curated documentation — not hand-coded. As integrations evolve, tools stay current without manual maintenance.

02

Fine-grained access control

Scope each MCP server to read-only, write-only, specific methods, or tagged tool groups. Expose only what your AI agent needs — nothing more.

03

Multi-tenant by design

Each MCP server is scoped to a single connected account with its own credentials. The URL itself is the auth token — no shared secrets, no credential leaking across tenants.

04

Works with every MCP client

Standard JSON-RPC 2.0 protocol. Paste the URL into Claude, ChatGPT, Cursor, or any MCP-compatible agent framework — tools are discovered automatically.

05

Built-in auth, rate limits, and error handling

Tool calls execute through Truto’s proxy layer with automatic OAuth refresh, rate-limit handling, and normalized error responses. No raw API plumbing in your agent.

06

Expiring and auditable servers

Create time-limited MCP servers for contractors or automated workflows. Optional dual-auth requires both the URL and a Truto API token for high-security environments.

How It Works

From zero to integrated

Go live with Mintlify in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s Mintlify account

Use Truto’s frontend SDK to connect your customer’s Mintlify account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call Mintlify

Truto’s Proxy API is a 1-to-1 mapping of the Mintlify API. You call us, we call Mintlify, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate Mintlify’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Mintlify on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

How do end users authenticate their Mintlify account?

End users connect their Mintlify workspace through Truto's hosted connect flow, which handles credential exchange and token storage. Your product calls Truto with the connection ID — you never store or refresh Mintlify credentials yourself.

Which Mintlify capabilities are available through Truto today?

Truto exposes tools across four domains: Assistant and agent workflows (messages, agent jobs, conversation history, caller stats), deployments (project updates and previews with status polling), knowledge discovery (documentation search and structured page content retrieval), and analytics (page views, unique visitors, search queries, and per-page feedback).

Is there a Unified API for Mintlify?

Mintlify is currently available as a native integration via Truto's tool catalog rather than behind a Unified API. If you need it normalized into a Knowledge Management Unified API alongside other providers, Truto builds those on request.

How do I handle long-running deployments like preview builds?

Calls like create_a_mintlify_project_preview and create_a_mintlify_project_update return a status ID. Poll get_single_mintlify_project_update_status_by_id until the build completes, then read the resulting preview URL or deployment metadata from the response.

Can I paginate through large analytics or feedback datasets?

Yes. Endpoints like list_all_mintlify_feedback_by_page, list_all_mintlify_page_views, list_all_mintlify_search_queries, and list_all_mintlify_assistant_conversations support pagination through Truto's standard cursor parameters, so you can backfill history and then incrementally sync.

How fresh is the data returned from Mintlify?

Reads are performed against Mintlify's live API at request time, so analytics, search queries, feedback, and assistant conversations reflect the latest state available from Mintlify's ClickHouse-backed telemetry. Truto does not cache responses by default.

MintlifyAPI integration