Skip to main content
Base is in beta and subject to change.
Bases are a type of project in Mintlify. They’re commonly used for knowledge bases for your team and the agents they work with. Keep specs, runbooks, onboarding guides, and other internal team knowledge in a base. Connect your base to Claude, ChatGPT, Cursor, and other AI tools through MCP so agents work from the same information your team does. A base uses the same editor and agent as your docs projects. The same workflows apply to both project types.

​
How a base differs from docs

A base is one of two project types. Because a base has no site, settings that only apply to a site, such as custom domains, the assistant, and analytics, aren’t available for a base. You also organize a base with only pages and groups. You cannot use tabs, anchors, versions, languages, or other navigation elements.

​
Where your pages are stored

The editor sidebar in a base contains three types of pages.
  • Teamspace: Pages your entire organization shares. Mintlify stores Teamspace pages as MDX files in a Git repository and commits your edits automatically.
  • Personal: Private pages for your drafts or content that’s just for yourself. Private pages aren’t stored in Git. They stay private to you unless you share them with teammates. If you want to share a private page, open its options menu, select Move within project, and choose Teamspace or a group inside it.
  • Shared with me: Pages that teammates shared with you directly.
New bases use a Git repository that Mintlify hosts for you. To work on your base locally with your own tools, connect a GitHub, GitLab, Bitbucket, or Azure Repos repository in your Git settings. Commits you push to the connected repository update your base.

​
How people and agents contribute

Your team can update a base wherever they work:
  • Editor: Write and organize pages in your browser or the desktop app, with help from the agent.
  • MCP: Connect Claude, ChatGPT, Cursor, or another AI tool to the admin MCP to read, search, and edit your base from a conversation.
  • Slack: Ask the Mintlify agent in Slack questions that it answers from your base, or ask it to update pages.
  • Git: Clone your base’s repository and edit the MDX files with any editor or coding agent.

​
Share a page to the web

On Pro and Enterprise plans, you can share a base page with people outside your organization through a public link. Anyone with the link can view the page without signing in. They can’t edit it. Public links are off by default. An admin must turn on Allow public links in the Sharing section of your Security settings. To share a page, open it in the editor, open the page options menu, and turn on Share to web. You can share a Teamspace page if you have the editor or admin role. You can share a private page if you have Full Access to it. While a page is shared, a globe button appears in the top bar. Click it, or select Copy public link in the page options menu, to copy the link. The public page shows the page’s current content. Each public page also has a Markdown version for AI tools. Add .md to the end of the public link to view it, or request the link with an Accept: text/markdown header. To stop sharing, turn off Share to web and confirm. The link stops working right away. If you share the page again, it gets a new link. If an admin turns off Allow public links, every public link stops working until an admin turns the setting back on.

​
Features and plans

Bases have their own Starter, Pro, and Enterprise plans, separate from the plans for your docs projects. To view or change your base’s plan, go to your Billing settings. Every plan includes the editor, Git sync, and the admin MCP. Pro also includes the agent. Enterprise adds SSO, SCIM, role-based access control, and additional features. See the pricing page for more information.

​
Get started

Set up a base

Create a base, invite your team, and connect your AI tools.