# Mintlify MCP for AI Agents AI Agent Connect

> Mintlify MCP lets you manage your documentation directly through your AI agent. You can pull project metadata, update configuration settings, check page view analytics, and trigger new deployments without leaving your chat interface. It's the bridge between your documentation platform and your AI workflow.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_M9aK5cxlba7CD7hPXRmZkQWDWejHvt8xp1tZNLBC/ai-agent-connect
- **Tags:** documentation, api-docs, deployment, analytics, technical-writing

## Description

Keeping documentation accurate is usually a chore of jumping between your code editor, your terminal, and the Mintlify dashboard. You have to hunt for the right configuration file, wait for builds to finish, and manually check how many people actually read your guides. This Connector changes that by letting your AI agent handle the heavy lifting for you. Instead of clicking through menus to see how your navigation is structured or checking if a deployment actually went through, you just ask your agent to do it. You can pull your project settings, tweak your documentation's configuration, or grab traffic stats for the last month in seconds. It's a huge win for keeping your docs in sync with your actual product. Since Vinkius hosts this, you can plug it into your existing setup and start managing your technical docs through a simple conversation. It turns a manual maintenance task into a quick command. You don't have to worry about finding the right buttons or navigating complex settings menus. Your agent handles the communication with the Mintlify platform so you can stay focused on building features. Whether you need to update a single navigation link or check the overall health of your documentation traffic, the process is now a single request away.

## Tools

### get_metadata
Pulls your project's current settings and navigation structure into your chat. This helps you audit your docs without opening the dashboard.

### get_page_views
Fetches page view statistics for specific date ranges. Use this to see exactly how many people visited your guides last week.

### trigger_deployment
Starts a new Mintlify documentation build immediately. This is ideal for manual CI/CD overrides or quick refreshes.

### update_metadata
Modifies your documentation's configuration object through a request. Use this to change navigation or settings on the fly.

## Prompt Examples

**Prompt:** 
```
Can you show me the navigation structure for my project?
```

**Response:** 
```
I've pulled your project metadata. Your documentation is currently configured with the navigation structure including 'Introduction', 'API Reference', and 'Guides'. Would you like to see the full JSON configuration?
```

**Prompt:** 
```
How many people looked at our docs in the last 30 days?
```

**Response:** 
```
Fetching analytics... In the last 30 days, your documentation received a total of 12,450 page views. The most visited page was '/api-reference/authentication'.
```

**Prompt:** 
```
I just pushed a fix, can you start a new deployment for the docs?
```

**Response:** 
```
Deployment triggered successfully! Mintlify is now building the latest version of your documentation. You can check the status in your dashboard.
```

## Capabilities

### Pull project metadata
Get your current documentation settings and navigation structure into your chat interface.

### Update documentation configs
Modify your documentation configuration object through a simple natural language request.

### Check page view stats
Fetch analytics for specific date ranges to see how users are interacting with your guides.

### Trigger manual deployments
Start a new documentation build immediately without leaving your code editor.

### Inspect navigation structures
Audit your documentation's organization and top-level categories instantly.

### Track user engagement metrics
Retrieve specific traffic data to understand which parts of your docs are most popular.

## Use Cases

### Updating navigation without finding the config file
A developer wants to swap the order of two links in the sidebar. They ask the agent to use `update_metadata` to swap 'Guides' and 'API Reference' in the navigation object.

### Checking traffic for a new feature guide
A product manager wants to see if people are reading the new onboarding docs. They ask the agent to use `get_page_views` for the last 3 days and summarize the results.

### Forcing a documentation build
A dev just pushed a critical fix and needs the docs to update now. They ask the agent to use `trigger_deployment` to start the build immediately.

### Auditing documentation structure
A technical writer needs to see the current top-level categories to plan a reorganization. They ask the agent to use `get_metadata` to list the navigation structure.

## Benefits

- Stop switching tabs by using `update_metadata` to change your documentation settings directly in your chat.
- Get instant feedback on your docs by using `get_page_views` to see exactly what your users are reading.
- Speed up your release cycle by using `trigger_deployment` to kick off builds without leaving your editor.
- Audit your navigation easily with `get_metadata` to ensure your documentation structure stays organized.
- Keep your configuration in sync with your code by automating metadata updates through your agent.

## How It Works

The bottom line is you get a direct line to your documentation's backend without ever opening a browser tab.

1. Subscribe to the Mintlify MCP on Vinkius.
2. Enter your Mintlify API Key in your agent's configuration.
3. Ask your agent to update a config, pull analytics, or start a deployment.

## Frequently Asked Questions

**What can I do with the Mintlify MCP?**
You can manage your documentation metadata, check page view analytics, and trigger new deployments directly through your AI agent without leaving your editor.

**How do I update my docs config with Mintlify?**
Just ask your agent to update the configuration. It will use the `update_metadata` tool to modify your settings for you.

**Can I see how many people visited my docs?**
Yes, your agent can fetch page view statistics for any specific time range you specify, giving you a quick look at user engagement.

**Can I trigger a build manually?**
Absolutely. You can ask your agent to start a new documentation deployment whenever you need one to go live.

**Is this for technical writers?**
Yes, it is a great tool for technical writers who need to audit navigation structures, check metadata, and monitor how users are interacting with the guides.

**Do I need to leave my editor to use this?**
No, the whole point is to stay in your editor or chat interface. This Connector connects your AI client directly to the Mintlify backend.

**How can I check the current navigation structure of my documentation?**
You can use the `get_metadata` tool. It retrieves the complete project metadata, including settings and the navigation hierarchy defined in your configuration.

**Is it possible to see how many views my pages received last week?**
Yes! Use the `get_page_views` tool and provide the optional start and end dates in ISO 8601 format to filter the analytics for that specific period.

**Can I trigger a production build of my docs using the AI?**
Absolutely. By calling the `trigger_deployment` tool, the agent will send a request to Mintlify to start a new deployment process immediately.