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.

​
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.