> ## Documentation Index
> Fetch the complete documentation index at: https://docs.versuno.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Overview

> Versuno MCP server — expose your AI assets to any MCP-compatible coding agent.

The Versuno MCP server implements the [Model Context Protocol](https://modelcontextprotocol.io) so coding agents can query public brains and search, load, and sync your Versuno assets without leaving their editor. It works with Cursor, Claude Code, Cline, Claude Desktop, VS Code, Windsurf, Zed, Antigravity, and any other MCP-compatible client.

The tools fall into two groups: **Brains** for pulling accurate, up-to-date context out of indexed knowledge bases, and **Prompt Manager** for working with your own AI assets.

## Brains

* **Find a brain** with `list_public_brains`. Lists the public [brains](/brains/overview) you can query, such as indexed library and framework docs.
* **Query for context** with `query_brain`. Returns the most relevant passages for a question, ranked, with sources.
* **See the structure** with `get_brain_tree`. Shows a brain's container hierarchy as an outline.
* **Read full content** with `get_brain_node`. Fetches the complete source behind a query result.

## Prompt Manager

* **Load assets into context** with `get_asset`. The agent reads the full content of a prompt, persona, context, system prompt, or skill.
* **Search your library** with `search_assets` before loading, so the agent only pulls what's relevant.
* **Sync to disk** with `pull_asset`. Writes a markdown file with YAML frontmatter into `.versuno/`.
* **Push back** with `push_asset`. Edits made in your editor become new versions in Versuno cloud.

Not sure whether to use the MCP or the CLI? See [MCP vs CLI](/mcp-vs-cli).

## Quick start

1. Get an API key from [versuno.ai/settings/api-keys](https://versuno.ai/settings/api-keys).

2. Add the server to your MCP client. For Cursor:

   ```json theme={null}
   {
     "mcpServers": {
       "versuno": {
         "command": "npx",
         "args": ["-y", "versuno-mcp"],
         "env": {
           "VERSUNO_API_KEY": "uk_live_xxx"
         }
       }
     }
   }
   ```

3. Restart the client. Your agent now has 9 new tools.

Prefer not to install anything? Point your client at the hosted server instead — `https://mcp.versuno.ai/mcp` with your API key as a bearer token. See [Setup → Remote (hosted HTTP) server](/mcp/setup#remote-hosted-http-server) for details (the hosted server offers the read/query tools; `pull_asset`/`push_asset` stay local-only).

For setup in other clients, see [Clients](/mcp/clients/cursor).

## Package

Published on npm as [versuno-mcp](https://www.npmjs.com/package/versuno-mcp).