For AI assistants
NOVI over MCP
NOVI has its own Model Context Protocol server, so assistants that support MCP can search, explain and compare the catalogue for you.
Hosted endpoint not yet announced
The public MCP address will be published at launch. The configuration below shows the format.1. Create an access token
In Settings → Access tokens, create a token. Tokens are read-only. You can revoke a token at any time.
2. Add NOVI to your assistant
Add this to your MCP client's configuration, replacing the token:
{
"mcpServers": {
"novi": {
"type": "http",
"url": "https://<your-novi-mcp-host>/mcp",
"headers": {
"Authorization": "Bearer novi_pat_…"
}
}
}
}3. What the assistant can do
| Tool | What it does | Token scope |
|---|---|---|
| search_projects | Search the catalogue in natural language, with filters. | catalogue:read |
| get_project | Full details for one project, including licence and trust information. | catalogue:read |
| compare_projects | Side-by-side comparison of two to four projects. | catalogue:read |
| check_compatibility | Compatibility and evidence for one operating system, or for one of your devices. | catalogue:read |
| get_installation_requirements | Requirements and installation methods for a project. | catalogue:read |
Safety
- The MCP server is read-only. It can search and describe the public catalogue; it cannot install anything or change your account.
- Catalogue text is third-party data. NOVI tells assistants not to treat it as instructions.
- Requests are rate limited per token, and you can revoke a token at any time.