What Major Vault is

Major Vault connects an AI assistant to the Markdown notes in your GitHub repositories. The assistant can read, search and change them, with your own GitHub rights, and every change becomes a commit.

It speaks MCP, the Model Context Protocol. MCP is how an assistant such as Claude or ChatGPT finds the tools a server offers (tools/list), shows them to its model, and sends the model’s calls (tools/call).

How it fits together

1. An admin installs the GitHub App on a personal account or an organisation, say Acme, and picks the repositories it may reach.
2. We switch the installation on and give it a name. Acme’s address is then https://vlt.majortom.ai/acme.
3. Everyone at Acme adds that one address to their assistant and signs in with their own GitHub account.

From then on, the assistant works in every selected repository that person can read on GitHub, and writes only where they may write.

What an assistant gets

• Basic tools, the same everywhere: read, list, search, the history, edit, move, create, and tables from the notes. They work in every repository, plain Markdown or configured.
• Special tools, where a repository switches them on for a workflow of its own. They carry the repository’s name and work only there.
• Instructions: a short paragraph of the service’s own, then each readable repository’s own.

A person sees nothing of a repository they cannot read, not even its name.

What it is not

• Not a copy of your notes. GitHub stays the source of truth. Major Vault keeps an index to read from quickly, and writes only through GitHub.
• Not an account system. Who may read and write is what GitHub says, checked with each person’s own token.