MCP setup

Vistai MCP

Documentation

Connect your private Skill Graph to Cursor, Claude Desktop, Windsurf, and any HTTP MCP client.

Ready to connect?

Sign in and open Settings → Vistai MCP to copy your personal config.

What is Vistai MCP?

Vistai MCP is a private, hosted Model Context Protocol server. It lets AI assistants in your IDE read your Skill Graph — domains, missions, streak, and sanitized activity — without exposing anything publicly.

Connect vs MCP

  • Connectors (/connectors) send data in from GitHub, Notion, and Figma.
  • Vistai MCP sends your Skill Graph out to Cursor, Claude, VS Code, Zed, Windsurf, JetBrains, ChatGPT, and other HTTP MCP clients.
  • They work together: Connect feeds the graph; MCP lets AI read it.

Hosted endpoint

Production URL: https://mcp.vistai.site (Streamable HTTP JSON-RPC). No local packages or stdio servers required.

NoteYour Skill Graph is never public. MCP always requires your personal Bearer token.

Quick start

Connect Vistai to your IDE in a few minutes. You need a Vistai account and access to Settings → Vistai MCP.

  1. 1Sign in at vistai.site and open Settings → Vistai MCP.
  2. 2Your token loads automatically — click Copy config when ready.
  3. 3Paste into your IDE MCP config (see IDE setup guides below).
  4. 4Restart or reload MCP in your IDE if needed.
  5. 5Verify with this prompt: “What skill domains am I active in on Vistai? Use the get_skill_domains tool.”

Cursor

Cursor supports remote HTTP MCP servers via mcp.json.

Config location

~/.cursor/mcp.json (global) or .cursor/mcp.json (project)

Steps

  1. 1Open Settings → Vistai MCP and click Copy config.
  2. 2Open ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
  3. 3Merge the vistai block under mcpServers.
  4. 4Reload MCP in Cursor Settings → MCP — you should see tools listed.

Claude Desktop

Claude Desktop reads MCP servers from its developer config file.

Config location

Settings → Developer → Edit Config

Steps

  1. 1Copy your config from Settings → Vistai MCP.
  2. 2Open Claude Desktop → Settings → Developer → Edit Config.
  3. 3Add the vistai entry under mcpServers.
  4. 4Restart Claude Desktop.

Windsurf

Windsurf uses mcp_config.json for MCP server definitions.

Config location

MCP settings → mcp_config.json

Steps

  1. 1Copy your config from Settings → Vistai MCP.
  2. 2Open Windsurf MCP settings.
  3. 3Paste the vistai server into mcp_config.json.
  4. 4Reload MCP servers in Windsurf.

VS Code

VS Code with GitHub Copilot supports remote HTTP MCP servers.

Config location

GitHub Copilot → MCP config or .vscode/mcp.json

Steps

  1. 1Copy your config from Settings → Vistai MCP.
  2. 2Open VS Code → GitHub Copilot MCP settings (or .vscode/mcp.json for workspace scope).
  3. 3Add the vistai entry under mcpServers.
  4. 4Reload the window or restart MCP in Copilot settings.

Zed

Zed supports remote MCP servers in Assistant settings.

Config location

Settings → Assistant → Model Context Protocol

Steps

  1. 1Copy your config from Settings → Vistai MCP.
  2. 2Open Zed → Settings → Assistant → Model Context Protocol.
  3. 3Add a new remote server using the vistai url and Authorization header.
  4. 4Restart the assistant panel if tools do not appear immediately.

Cline

Cline (VS Code extension) supports HTTP MCP servers alongside built-in tools.

Config location

Cline extension → MCP Servers

Steps

  1. 1Copy your config from Settings → Vistai MCP.
  2. 2Open the Cline panel → MCP Servers (or extension settings).
  3. 3Add the vistai server block from your copied config.
  4. 4Start a new Cline task so it picks up the tools.

Continue

Continue supports MCP in VS Code, JetBrains, and other hosts via config.json.

Config location

Continue config → mcpServers

Steps

  1. 1Copy your config from Settings → Vistai MCP.
  2. 2Open ~/.continue/config.json (or your workspace Continue config).
  3. 3Merge the vistai entry under mcpServers.
  4. 4Reload Continue in your editor.

JetBrains AI

JetBrains AI Assistant supports remote MCP servers in supported IDEs.

Config location

Settings → Tools → AI Assistant → MCP

Steps

  1. 1Copy your config from Settings → Vistai MCP.
  2. 2Open Settings → Tools → AI Assistant → MCP.
  3. 3Register a remote HTTP server with the vistai url and Bearer token.
  4. 4Open the AI chat tool window and confirm Vistai tools are listed.

ChatGPT

ChatGPT desktop supports custom MCP connectors on plans that include developer features.

Config location

ChatGPT desktop → Settings → Connectors / MCP

Steps

  1. 1Copy your config from Settings → Vistai MCP.
  2. 2Open ChatGPT desktop → Settings → Connectors or MCP.
  3. 3Add a custom remote server using the vistai url and Authorization header.
  4. 4Start a new chat and confirm Vistai tools are available.

More MCP clients

The same remote HTTP JSON works in any client that supports Streamable HTTP MCP.

Also compatible

  • Replit Agent: Add a remote MCP server in agent settings when HTTP MCP is supported.
  • Warp / Goose / OpenCode: Any tool that accepts Streamable HTTP MCP url + Bearer auth works with Vistai.

Config shape

Use url: https://mcp.vistai.site and headers.Authorization: Bearer <your-token>. The full block is available from Settings → Vistai MCP → Copy config.

Tools

Tools your assistant can call once connected.

  • Skill domains — Seven-domain radar — design, engineering, product, writing, research, communication, data.
  • Missions — Active planets and today's tasks on Vistai.
  • Streak — Current and max task-completion streak.
  • Activity summary — Sanitized 7/30-day activity by domain — no repo names or private titles.
  • Skill graph — Full graph: domains, active planets, streak, and sanitized recent activity.
NotePlus and Max plans unlock get_activity_summary with Connect integration data.

Resources

Read-only resources exposed by Vistai MCP.

  • Skill domains (vistai://skill-graph/domains) — Seven-axis domain radar as JSON
  • Skill graph summary (vistai://skill-graph/summary) — Markdown summary of active domains
  • Career brief (vistai://profile/career-brief) — One-page narrative of what you work on

Prompts

Built-in prompts for career and interview prep.

  • Career summary — One-page narrative from domains and active planets.
  • Interview prep — Role-specific brief from your skill graph and missions.

Security & privacy

Vistai MCP is designed for private, authenticated access only.

  • One personal token per account — rotate anytime to revoke old IDE configs.
  • Tokens are encrypted at rest; never share them in chat or public repos.
  • OAuth tokens from Connect are never exposed via MCP.
  • Activity summaries are sanitized — no raw repo names or private titles.
  • Skill Graph is not available on public profile URLs.

Troubleshooting

Common issues when connecting Vistai MCP.

Setup unavailable on the settings page

  • Ensure you are signed in and try refreshing the page.
  • If the issue persists, contact support — server configuration may need attention.

IDE does not show Vistai tools

  • Confirm mcp.json uses the correct url and Authorization header.
  • Restart the IDE or reload MCP servers after editing config.
  • Rotate your token and copy a fresh config if you suspect an old token.

Tools return limited data

  • Free plan: basic MCP (domains, missions, streak, skill graph).
  • Plus/Max: full MCP including activity summaries from Connect.
  • Connect tools on the Connectors page to populate domain activity.