The contextual toolbar is a floating action bar that appears on every page of your docs. It lets readers instantly copy page content, open it in an AI assistant, or add your docs as an MCP server — without leaving the page.
Configure it in docs.json under contextual.options:
{
"contextual": {
"options": ["copy", "view", "claude", "chatgpt", "mcp", "cursor", "vscode"]
}
}
Available options
Content actions
| Option | Description |
|---|
copy | Copies the page as Markdown to the clipboard |
view | Opens the raw Markdown version of the page (.md URL) |
AI assistants
| Option | Description |
|---|
claude | Opens the page in Claude |
chatgpt | Opens the page in ChatGPT |
perplexity | Opens the page in Perplexity |
grok | Opens the page in Grok |
aistudio | Opens the page in Google AI Studio |
Editor integrations
| Option | Description |
|---|
cursor | Adds the page to Cursor’s context |
vscode | Adds the page to VS Code Copilot |
windsurf | Adds the page to Windsurf’s Cascade |
devin | Opens the page in Devin |
MCP
| Option | Description |
|---|
mcp | Shows instructions for using your docs as an MCP server |
add-mcp | Provides a one-click prompt to add your docs MCP server to an AI tool |
The mcp and add-mcp options are especially powerful — they let developers connect your entire docs site to any MCP-compatible AI assistant, so it can answer questions about your product directly.
Custom options
You can add custom entries to the toolbar with a title, description, icon, and link. The href supports dynamic placeholders:
| Placeholder | Resolves to |
|---|
$page | The current page’s full URL |
$path | The current page’s path |
$mcp | Your docs MCP server URL |
{
"contextual": {
"options": [
"copy",
"claude",
{
"title": "Open issue",
"description": "Report a problem with this page",
"icon": "github",
"href": "https://github.com/your-org/docs/issues/new?title=Issue+on+$path"
}
]
}
}
The contextual toolbar is only visible on preview and production deployments, not in mint dev local preview.
Pairing with Visibility
The toolbar’s copy and view options expose your page’s Markdown content directly. If you use the Visibility component, the for="agents" blocks will be included in that Markdown — giving AI assistants structured context that human readers don’t see. 
