Tokens
Learn which tokens exist in BaseHub and what they are for.
Read Token
The most commonly used token in BaseHub, has unrestricted read access scoped to a repository. By default, you should be using this token.
Unrestricted read access means the token can retrieve all content, metadata, and structure within its assigned repository, including drafts and published content across all collections. However, it cannot perform any write operations or access content from other repositories.
Read more on how to use this toke in the Query documentation.
Hidden blocks
Blocks that are hidden don’t pass through commit validation (e.g: required blocks won’t fail if they’re empty) and won’t be exposed in the API, not even in draft mode.
Admin Token
Handle this token with greater care as it includes all Read Token permissions plus write access to the repository. This token can be used by a team member or by the AI agents to make updates via the Mutation API.
MCP Token
This token has a very specific purpose and it’s to give permissions to the BaseHub MCP Server to read and write into your repository. This token, in comparison to the read and admin tokens, isn’t one per repo, rather it’s one per repo and user. So each team member will have a different MCP Token.