MCP server
Hosted MCP server for Cursor, Claude Desktop, ChatGPT, and similar clients.
MCP server
Connect MCP-compatible assistants to AUVY without writing client code. Canonical docs: auvy-sdk MCP.md · apps/mcp-server/README.md.
Endpoint:
https://mcp.auvy.ai/mcpAI agents: agent-onboarding/SKILL.md · llms.txt
Setup — OAuth (recommended)
Install the Cursor plugin or add URL-only config:
{
"mcpServers": {
"auvy": {
"type": "http",
"url": "https://mcp.auvy.ai/mcp"
}
}
}Complete browser sign-in at https://auvy.ai/os/oauth/authorize when prompted. No API key in MCP config.
Client paths: Cursor → Settings → MCP (or plugin auto-wires) · Claude Desktop → claude_desktop_config.json · see Plugins.
Optional headers: X-Brain-Id (brain-scoped tools), X-MCP-Toolkit-Slug (toolkit selection).
Setup — API key (automation)
For CLI, CI, or clients without OAuth:
- Create an API key at auvy.ai/os → Admin → API keys.
- Add Bearer header to MCP config. See auvy-sdk examples/mcp-cursor-api-key.
Vault discovery
MCP tools and CLI commands share the same contracts via @auvy-os/client.
Confirm session
MCP: get_session · CLI: auvy vault session --json
Browse folders
MCP: vault_browse · CLI: auvy vault document-tree --prefix /
Search
MCP: grep (lexical) or semantic_search (conceptual) · CLI: auvy vault grep or auvy vault search
Read
MCP: read · CLI: auvy vault read <resource_id>
Ingest
MCP: ingest · CLI: auvy vault ingest --text "..." --name "Notes" --path /Research
| Tool | Purpose |
|---|---|
get_session | Workspace and brain context — call first |
vault_browse | Folder browse by prefix |
semantic_search | Brain-wide vector search |
grep | Brain-wide lexical search |
read | Full document by resource_id |
ingest | Text or URL into the vault |
Operator tools
Catalog is filtered by workspace MCP toolkit. Default surface includes session, discovery, ingest, patches, spreadsheet SQL, Postgres SQL, and management tools (neuron/pathway/receptor/reflex CRUD, connect_execute, receptor__{slug}).
Example flows
Session context:
{ "tool": "get_session", "arguments": {} }Browse then read:
{ "tool": "vault_browse", "arguments": { "prefix": "/Research" } }Related
- Quickstart — connect in 60 seconds
- Plugins — Cursor, Codex, Claude install guides
- CLI — same discovery contracts for terminals