Connect via MCP

Mintlify generates a hosted MCP server from these docs. Connect it to your AI tools so they can search Buttons documentation and retrieve full page content directly — no browser, no copy-paste. The MCP server exposes two tools:

Search — find relevant docs pages by query
Get page — retrieve the full content of a specific page by path

Your AI tool decides when to use these tools based on the conversation context. If you ask about creating an HTTP button, it searches the docs and pulls the relevant page automatically.

This is the docs-search MCP server — it lets an agent read these documentation pages. It is not the same as running Buttons as an MCP server. To expose your own buttons to an agent as deterministic, pressable tools, run buttons mcp (only buttons marked "mcp_enabled": true are listed/pressable).

Connect to your AI tool

Claude Code
Claude (web)
Cursor
VS Code

Add the Buttons docs MCP server to Claude Code:

claude mcp add --transport http buttons-docs https://buttons.mintlify.app/mcp

Verify:

claude mcp list

Now ask Claude Code about Buttons and it can search these docs during response generation.

Open Claude settings

Go to Connectors in your Claude settings.

Add the MCP server

Select Add custom connector and enter:

Name: Buttons
URL: https://buttons.mintlify.app/mcp

Use it in chat

Select the attachments button (plus icon) in any conversation, then select the Buttons connector. Claude searches these docs to answer your questions.

Open MCP settings

Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux), search for “Open MCP settings”, and select Add custom MCP.

Add the server config

In mcp.json:

{
  "mcpServers": {
    "buttons-docs": {
      "url": "https://buttons.mintlify.app/mcp"
    }
  }
}

Test it

In Cursor’s chat, ask “How do I create an HTTP button with Buttons CLI?” — Cursor should search these docs and return an accurate answer.

Create .vscode/mcp.json in your project:

{
  "servers": {
    "buttons-docs": {
      "type": "http",
      "url": "https://buttons.mintlify.app/mcp"
    }
  }
}

Quick install from any docs page

Select any text on this docs site and use the contextual menu to:

Copy MCP server URL — paste into your tool’s MCP configuration
Connect to Cursor — one-click install into Cursor
Connect to VS Code — one-click install into VS Code

MCP + skill.md

MCP and the skill.md capability file serve complementary roles:

	MCP server	skill.md
What it provides	Real-time search across all docs pages	Full CLI reference in one file
How the agent uses it	Searches on demand during conversation	Loaded into context at session start
Stays current	Auto-indexed on every docs deployment	Auto-generated from the Cobra command tree (`go run ./internal/tools/skillgen`)
Best for	Deep questions, discovering pages, getting full page content	Quick reference, offline use, CI agents without network

Use both: load skill.md for baseline context, connect the MCP server for deep dives.

The MCP server URL above uses buttons.mintlify.app. If you’re self-hosting or using a custom domain, replace with your actual docs URL followed by /mcp.

​Connect to your AI tool

​Quick install from any docs page

​MCP + skill.md

Connect to your AI tool

Quick install from any docs page

MCP + skill.md