Mintlify MCP Server
for AI Agents
Connect your AI agent to StackOne's Mintlify MCP server and give it ready-to-use MCP tools out of the box. Auth, tool execution, and security all managed.
StackOne 
Coverage
16 Agent Actions
Create, read, update, and delete across Mintlify — and extend your agent's capabilities with custom actions.
Authentication
Agent Tool Authentication
Per-user OAuth in one call. Your Mintlify MCP server gets session-scoped tokens with zero credentials stored on your infra.
Agent Auth →
Security
Agent Protection
Every Mintlify tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.
Prompt Injection Defense →
Performance
Max Agent Context. Min Cost.
Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every Mintlify call.
Tools Discovery →What is the Mintlify MCP Server?
A Mintlify MCP server lets AI agents read and write Mintlify data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's Mintlify MCP server ships with pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, observability, and agent execution runtime. Connect it from MCP clients like Claude Desktop, Claude Code, Cursor, Goose, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.
All Mintlify MCP Tools
Every action from Mintlify's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.
Trigger Deployments
- Trigger Deployment
Trigger a documentation deployment to publish updates from your configured branch
Trigger Preview Deployments
- Trigger Preview Deployment
Trigger a preview deployment for a Git branch, creating a new preview or redeploying an existing one (POST /project/preview/{projectId}). Requires Admin API key (mint_ prefix) and a Pro or Enterprise plan.
Deployment Status
- Get Deployment Status
Get the status of a deployment update by its status ID
Agent Jobs
- Create Agent Job
Initiates an AI-powered background job to automatically generate documentation updates and create pull requests with the changes
- Get Agent Job
Retrieves the current status, progress, and details of a specific agent job by its unique identifier for monitoring documentation generation
Agent Follow-up Messages
- Send Agent Follow-up Message
Sends additional instructions or refinements to an active agent job to iteratively improve documentation output without creating a new job
Documentations
- Search Documentation
Search through documentation using semantic and keyword search
Page Contents
- Get Page Content
Retrieve the full text content of a documentation page by its path
Assistant Messages
- Create Assistant Message
Generate a streaming response from the AI assistant trained on your documentation
User Feedbacks
- Get User Feedback
Retrieve user feedback from your documentation including page ratings and code snippet feedback
Feedback By Pages
- Get Feedback By Page
Retrieve user feedback counts aggregated by documentation page
Assistant Conversations
- Get Assistant Conversations
Retrieve AI assistant conversation history including queries, responses, and cited sources
Assistant Caller Stats
- Get Assistant Caller Stats
Retrieve assistant query volume broken down by caller type (web, API, other) for a specified date range, enabling channel-level usage analysis. Requires Admin API key (mint_ prefix) and is not accessible with an Assistant API key.
Queries
- Get Search Queries
Retrieve documentation search terms with hit counts, click-through rates, and top clicked pages
Page Views
- Get Page Views
Retrieve per-page and site-wide content view counts split by human and AI traffic
Unique Visitors
- Get Unique Visitors
Retrieve per-page and site-wide approximate unique visitor counts split by human and AI traffic
Set Up Your Mintlify MCP Server in Minutes
One endpoint. Any framework. Your agent is talking to Mintlify in under 10 lines of code.
Agent Frameworks
JSON{
"mcpServers": {
"stackone": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://api.stackone.com/mcp?x-account-id=<account_id>",
"--header",
"Authorization: Basic <YOUR_BASE64_TOKEN>"
]
}
}
}Platform Resources
MCP Code Mode: Keeping Tool Responses Out of Agent Context
Anthropic's code_execution processes data already in context. Custom MCP code mode keeps raw tool responses in a sandbox. 14K tokens vs 500.
11 min
Comparing BM25, TF-IDF, and Hybrid Search for MCP Tool Discovery
Benchmarking BM25, TF-IDF, and hybrid search for MCP tool discovery across 916 tools. The 80/20 TF-IDF/BM25 hybrid hits 21% Top-1 accuracy in under 1ms.
10 min
Indirect Prompt Injection Defense for MCP Tools: A Technical Guide
MCP tools that read emails, CRM records, and tickets are indirect prompt injection vectors. Here's how we built a two-tier defense that scans tool results in ~11ms.
12 min
MCP vs A2A: Architecture, Security, and When to Use Each
MCP vs A2A: what each protocol standardizes, how they differ, their shared security risks including indirect prompt injection, and when to use one, both, or a hybrid architecture.
12 min
MCP vs API: What 200+ Connector Builds Taught Us
MCP wraps APIs, it doesn't replace them. After building 200+ connectors that serve both, here's when each approach wins.
14 min read
Mintlify MCP Server FAQ
Does StackOne have a Mintlify MCP server?
Mintlify MCP server vs direct API integration — what's the difference?
How does Mintlify authentication work for AI agents?
origin_owner_id.Are Mintlify MCP tools vulnerable to prompt injection?
What is the context bloat of a Mintlify agent and how do I avoid it?
Can I limit which actions my Mintlify agent can access?
Can I create custom agent actions for my Mintlify MCP server?
When should I NOT use a Mintlify MCP server?
What AI frameworks and AI clients does the StackOne Mintlify MCP server support?
Put your AI agents to work
All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.