MCP Server

The DeepVista MCP server lets any compatible AI client read, search, create, edit, and delete your context cards — without leaving your coding environment or chat interface. All actions are automatically scoped to your currently active DeepVista project. No extra configuration needed.

MCP (Model Context Protocol) is an open standard for connecting AI clients to external data sources. Read the spec →

Endpoint

The MCP server uses Streamable HTTP transport with OAuth 2.1 authentication.

https://mcp.deepvista.app/mcp

Setup

Add the following to your Cursor MCP config file at ~/.cursor/mcp.json. Create the file if it doesn’t exist.

~/.cursor/mcp.json

{
  "mcpServers": {
    "deepvista": {
      "url": "https://mcp.deepvista.app/mcp"
    }
  }
}

Save the config and restart Cursor

Open the command palette

Press Cmd/Ctrl+Shift+P and run MCP: Connect to server.

A browser window will open — complete the OAuth flow to authorize the connection.

Confirm the connection

Return to Cursor. The server status should show Connected.

Verify it’s working: In Cursor’s AI chat, type List my DeepVista context cards. You should see a summary of cards from your active project.

Open or create your Claude Desktop config file and add the DeepVista server entry.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "deepvista": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.deepvista.app/mcp"
      ]
    }
  }
}

On Windows the config file is at %APPDATA%\Claude\claude_desktop_config.json.

Check your Node.js version

Claude Desktop uses npx to launch the bridge — Node.js 18+ is required. Run node --version to confirm.

Save the config and fully quit Claude Desktop

Use Cmd+Q on macOS or right-click the taskbar icon and select Quit.

Reopen Claude Desktop

A browser window will prompt you to sign in to DeepVista.

Complete the OAuth flow

You’ll be redirected back to Claude automatically once authorized.

Verify it’s working: Start a new Claude conversation and ask Show me my recent DeepVista context cards. A list from your active project should appear.

Run the following command to add the DeepVista MCP server:

claude mcp add --transport http deepvista-server https://mcp.deepvista.app/mcp

Then open a Claude Code session and run /mcp to go through the authentication flow.

Verify it’s working: Ask Claude Code to search my DeepVista cards for [any topic]. A matching result confirms the connection is live.

Press Ctrl/Cmd+Shift+P, search for MCP: Add Server, select Command (stdio), and enter:

npx mcp-remote https://mcp.deepvista.app/mcp

Name the server deepvista and hit enter. Then activate it via MCP: List Servers → select deepvista → Start Server.Alternatively, add it directly to your settings:

{
  "mcpServers": {
    "deepvista": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.deepvista.app/mcp"]
    }
  }
}

Press Ctrl/Cmd+, to open Windsurf settings. Scroll to Cascade → MCP servers, then select Add Server → Add custom server and paste:

{
  "mcpServers": {
    "deepvista": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.deepvista.app/mcp"]
    }
  }
}

Hundreds of tools now support MCP. Use these settings for any client not listed above.Native remote MCP (Streamable HTTP):

URL:   https://mcp.deepvista.app/mcp
Auth:  OAuth 2.1 (dynamic client registration)

Via mcp-remote bridge (stdio clients):

command:  npx
args:     -y mcp-remote https://mcp.deepvista.app/mcp

After adding the server, your client will open a browser window for the OAuth sign-in flow.

Verify it’s working: Ask your AI to search my DeepVista cards for [any topic you have a card on]. A matching result confirms the connection is live.

What you can do

Once connected, talk to your AI naturally. Here are some example prompts to get started.

Action	Example prompt
Find	`Find my context cards about machine learning pipelines`
Search	`Which cards mention series A fundraising?`
Create	`Create a new context card for Acme Corp — Q3 partnership notes`
Update	`Update my card on Sarah Chen with: joined the advisory board in May`
List	`Show me all context cards I've updated this week`
Delete	`Delete the context card titled Old vendor contract`

The AI will always confirm before deleting a card. To switch projects, change your active project in DeepVista — the MCP connection reflects it immediately.

Using an API key instead of OAuth

You can authenticate with a DeepVista API key instead of going through the interactive OAuth flow. This is useful for scripted workflows, read-only access, or integrating with an existing OAuth application. Generate a key from Settings → Security & Access, then configure your client to send:

Authorization: Bearer <your-api-key>

Troubleshooting

I'm getting an authentication error

Open deepvista.ai in your browser and confirm you’re signed in to the correct account. Then return to your AI client and try connecting again.If the issue persists, clear the stored auth cache and retry:

rm -rf ~/.mcp-auth

My client can't find or reach the server

Double-check that the endpoint URL in your config is exactly https://mcp.deepvista.app/mcp — no trailing slash.If you’re using the mcp-remote bridge, confirm Node.js 18+ is installed:

node --version

The AI connects but can't see any of my cards

The MCP server returns cards from your currently active project. Open DeepVista and confirm the correct project is selected in the project switcher. An empty list is expected if the active project has no cards yet.

I'm on Windows using WSL and seeing errors

Use this WSL-compatible configuration instead:

{
  "mcpServers": {
    "deepvista": {
      "command": "wsl",
      "args": ["npx", "-y", "mcp-remote", "https://mcp.deepvista.app/mcp"]
    }
  }
}

I see an internal server error when connecting

Clear saved auth info and try again:

rm -rf ~/.mcp-auth

You may also need to update to a newer version of Node.js if your current version is below 18.

CLI Quickstart

Capture notes and run workflows from your terminal using the DeepVista CLI.

Getting started

Endpoint

Setup

What you can do

Using an API key instead of OAuth

Troubleshooting

CLI Quickstart

Get Early Access

Getting started

Documentation Index

​Endpoint

​Setup

​What you can do

​Using an API key instead of OAuth

​Troubleshooting

CLI Quickstart

Get Early Access

Endpoint

Setup

What you can do

Using an API key instead of OAuth

Troubleshooting