Use with AI

Bring the kit to the AI you already use.

The Vamos UI MCP server gives any assistant the components, blocks, screen plans and code checks. Pick your client below: setup is one step, with no account and no API key.

Set up your client

Claude

Hosted server

claude.ai, Claude Desktop and the mobile apps share one connector list. Add it once on the web.

  1. Open connector settings

    In Claude, open Settings → Connectors and choose Add custom connector.

  2. Paste the URL

    Name it Vamos UI, paste the URL and add it. There is no sign-in step.

    https://mcp.vamos.ist/mcp
  3. Turn it on in a chat

    Enable the connector from the tools menu in the message box, then ask for a screen or a component.

On Team and Enterprise plans an owner may need to add the connector for the organisation first.

ChatGPT

Hosted server

Custom MCP servers are added in developer mode.

  1. Turn on developer mode

    Open Settings → Apps & Connectors → Advanced settings → Developer mode.

  2. Create the connector

    Create a connector with this URL and authentication No authentication.

    https://mcp.vamos.ist/mcp
  3. Use it in a chat

    Select it from the tools menu in a chat.

Menu names can differ by plan and app version.

Claude Code

Hosted server

One command in your terminal.

  1. Add the server
    claude mcp add --transport http vamos-ui https://mcp.vamos.ist/mcp
  2. Check it

    Run /mcp inside Claude Code; vamos-ui should be listed as connected.

For the project tools, run the server locally instead: claude mcp add vamos-ui -- npx -y @vamos-ui/mcp. Add --scope project to share it with your team through .mcp.json.

Cursor

Hosted server

Install with one click, or add the server to your project's config.

  1. Add the server

    Use the button above, or put this in .cursor/mcp.json (or ~/.cursor/mcp.json for every project):

    .cursor/mcp.json
    {
      "mcpServers": {
        "vamos-ui": {
          "url": "https://mcp.vamos.ist/mcp"
        }
      }
    }
  2. Check it

    Open the MCP list in Cursor's settings and make sure vamos-ui is enabled.

Local server with project tools: npx vamos-ui mcp add --client cursor.

VS Code

Hosted server

For GitHub Copilot in agent mode.

  1. Add the server

    Use a button above, or put this in .vscode/mcp.json:

    .vscode/mcp.json
    {
      "servers": {
        "vamos-ui": {
          "type": "http",
          "url": "https://mcp.vamos.ist/mcp"
        }
      }
    }
  2. Use it in agent mode

    Open Copilot Chat, switch to Agent and turn on the Vamos UI tools in the tools picker.

Local server with project tools: npx vamos-ui mcp add --client vscode.

Codex

Local server

Runs the server on your machine, with the project tools.

  1. Add the server
    codex mcp add vamos-ui -- npx -y @vamos-ui/mcp
  2. Or edit the config
    ~/.codex/config.toml
    [mcp_servers.vamos-ui]
    command = "npx"
    args = ["-y", "@vamos-ui/mcp"]

Same result: npx vamos-ui mcp add --client codex.

Windsurf

Local server

Runs the server on your machine, with the project tools.

  1. Write the config
    npx vamos-ui mcp add --client windsurf
  2. Or edit it yourself
    ~/.codeium/windsurf/mcp_config.json
    {
      "mcpServers": {
        "vamos-ui": {
          "command": "npx",
          "args": [
            "-y",
            "@vamos-ui/mcp"
          ]
        }
      }
    }

Gemini CLI

Local server

Runs the server on your machine, with the project tools.

  1. Write the config
    npx vamos-ui mcp add --client gemini
  2. Or edit it yourself

    .gemini/settings.json in the project, or ~/.gemini/settings.json for every project:

    .gemini/settings.json
    {
      "mcpServers": {
        "vamos-ui": {
          "command": "npx",
          "args": [
            "-y",
            "@vamos-ui/mcp"
          ]
        }
      }
    }

Zed

Local server

Runs the server on your machine, with the project tools.

  1. Add a context server
    settings.json
    {
      "context_servers": {
        "vamos-ui": {
          "command": {
            "path": "npx",
            "args": [
              "-y",
              "@vamos-ui/mcp"
            ]
          }
        }
      }
    }
  2. Use it in the agent panel

    The Vamos UI tools show up in the agent panel once Zed has started the server.

Any MCP client

Hosted server

Any client that supports remote MCP servers, or starts a local one.

  1. Remote server
    URL
    https://mcp.vamos.ist/mcp
    Transport
    Streamable HTTP, stateless (POST only)
    Sign-in
    None, no account or API key
  2. Or a local server

    Command npx, arguments -y @vamos-ui/mcp (stdio, Node 20 or later):

    npx -y @vamos-ui/mcp

MCP does not depend on the model: the tools work with whatever model your client runs, as long as it supports MCP tools.

What you can ask

  • “Plan a store admin dashboard with KPI cards, a revenue chart and the latest orders using Vamos UI.”plan_screen
  • “Check this component against the Vamos UI rules and fix what it finds.”verify_code
  • “Audit https://pinecrest-books.example before launch: metadata, sitemap, broken links and placeholder content.”audit_site
  • “Plan a website for Ozan & Partners, a small accounting firm: pages, appointment requests, forms and the legal pages.”start_project
  • “Our brand colour is #E4572E. Make it a Vamos UI accent and check the contrast.”propose_accent
  • “Which Vamos UI component should I use to pick a date range? Show me how to use it.”search

Hosted or local

Hosted

https://mcp.vamos.ist/mcp

Nothing to install. Every tool is read-only, and the server cannot see your files: paste the code you want checked into the chat. Works in chat apps such as Claude and ChatGPT.

Local

npx -y @vamos-ui/mcp

Runs next to your code. Adds the project tools: read your brand profile, check the whole project and plan updates. It writes files only when you ask it to.

Every tool, the hosted limits and self-hosting in the MCP docs

Product names and logos belong to their owners. They are shown only to indicate compatibility; Vamos UI is not affiliated with or endorsed by them.