Skip to content
Status

Mintlify

Connect Mintlify's hosted admin MCP server so users can read, edit, and publish their Mintlify docs and manage project settings within their dashboard role.

Sign in to the Mintlify dashboard with an account that can open the organization’s MCP settings. Each person who connects needs a Mintlify account with access to the projects they will work on. The connection inherits that person’s dashboard role: viewers can only use read tools, and protected settings need an admin role. To publish changes, the project’s GitHub, GitLab, or Bitbucket connection must have write access to the deploy branch’s repository.

Mintlify registers the Speakeasy OAuth client automatically, so you do not create an app or copy a client ID or secret. Mintlify does block sign-in from clients it does not recognize, so you add the Speakeasy redirect domain to its allowlist.

Allow the Speakeasy redirect domain

  1. In the Mintlify dashboard, open your MCP settings and go to Configure.

  2. Find the Redirect URIs section.

  3. Copy the hostname from the Speakeasy callback URL below. Enter only the hostname, without https:// or a path.

    https://ai.speakeasy.com/mcp/remote_login_callback
  4. Paste the hostname into Allowed domains and click Add domain.

The allowed domains also apply to your docs site’s search MCP server.

Add the server in Speakeasy

  1. In the Speakeasy AI Control Plane sidebar, under MCP Gateway, select MCP.

  2. Click Add new to open Add MCP server.

  3. Choose Hosted remotely.

  4. On New remote MCP server, paste this value into MCP server URL:

    https://mcp.mintlify.com
  5. Leave User session issuer at its default.

  6. Click Verify connectivity.

  7. Under Identity, keep User Identity selected.

  8. Click Save. This opens the server’s Overview page.

Speakeasy discovers Mintlify’s identity provider and registers an OAuth client automatically. There is no client ID or secret to paste. If registration does not complete, Speakeasy keeps the server Disabled until you finish setup in Settings > Identity.

Connect your credentials

Open the server’s Settings and find Identity. If the server already shows User Identity with the Mintlify provider and Auto-Configure, skip to step 5.

  1. Select User Identity.
  2. Under Choose an identity provider, confirm that https://mcp.mintlify.com is selected. If a different provider is selected, open the picker, search for mcp.mintlify.com, and select it.
  3. Keep Auto-Configure selected.
  4. Click Save.
  5. If the server shows Disabled, open Settings > Danger Zone > Server Availability and turn on Enable MCP server so it shows Enabled.

The first time each person uses the server, they sign in to Mintlify in their browser and authorize access. If sign-in does not return to Speakeasy, check that the Speakeasy hostname is listed in Mintlify’s allowed redirect domains.

If edit tools return insufficient_scope, the person’s Mintlify role does not allow that action. Raising their role later does not update an existing connection: Mintlify applies the added access only to a new connection.

This guide covers setup only. For tool behavior, publishing, and anything else beyond setup, see Mintlify’s admin MCP documentation.