Cursor

XO MCP Server — Cursor Setup Guide 🎉

Welcome! This quick guide shows you how to connect the XO MCP Server to Cursor so you can run XO’s tools right inside your editor. It’s a 2-minute setup. 🚀

What you’ll get

Once connected, you’ll see XO tools such as:

  • deploy_to_xo

  • start_xo_app

  • stop_xo_app

  • remove_xo_app

  • get_xo_app_logs

  • expose_xo_app

  • update_knowledgebase_using_text

  • ask_question

The exact list may grow over time — you’ll always see the current tools in Cursor.

Prerequisites ✅

  • Cursor (latest version).

  • uvx available on your machine (Cursor runs your MCP server via uvx).

    • macOS/Linux:

      curl -LsSf https://astral.sh/uv/install.sh | sh

    • Windows (PowerShell):

      irm https://astral.sh/uv/install.ps1 | iex

  • Your ACCESS_TOKEN and DEPLOYMENT_ID from the XO team.

Step 1 — Open MCP Tools in Cursor ✨

  1. Open Cursor → Settings (⌘, on Mac / Ctrl+, on Windows).

  2. In the settings search bar, type MCP.

  3. Click MCP Tools.

Step 2 — Add the XO MCP entry 🧩

  1. Click Add Custom MCP.

  2. Paste the following JSON into your MCP config (global or project-level is fine):

{
  "mcpServers": {
    "XO-MCP-Server": {
      "command": "uvx",
      "args": [
        "git+https://github.com/sharmasuraj0123/xo-mcp-server.git"
      ],
      "env": {
        "ACCESS_TOKEN": "<ACCESS_TOKEN_PROVIDED_BY_XO_TEAM>",
        "DEPLOYMENT_ID": "https://launchpad.xo.builders/"
      }
    }
  }
}

Notes:

  • Replace ACCESS_TOKEN with the real token you received from XO. 🔐

  • For DEPLOYMENT_ID, use the value provided by the XO team (often a base URL like https://launchpad.xo.builders/ or a specific deployment identifier they share with you).

  • If you prefer project-scoped config, save it at: <your-project>/.cursor/mcp.json

Step 3 — Verify and view tools 🎯

  1. Go back to Settings → Tools & Integrations → MCP Tools.

  2. You should see XO-MCP-Server with a green status indicator.

  3. Click Show tools to see the full list of available XO tools. 🎉

How to use the tools 🛠️

  • Open a chat in Cursor and describe what you want (e.g., “Deploy my app to XO”).

  • Cursor will surface the relevant MCP tools automatically.

  • If a tool needs parameters, Cursor will prompt you to fill them in.

Troubleshooting 🧯

  • “command not found: uvx” Install uv (see prerequisites) and restart Cursor.

  • No tools appear Double-check your JSON syntax. Make sure the entry is under "mcpServers".

  • Auth errors / permission denied Verify your ACCESS_TOKEN and DEPLOYMENT_ID are correct and active.

  • Still stuck? Toggle the MCP server off/on in Cursor’s MCP Tools, or restart Cursor.

Security tips 🔐

  • Never commit real tokens to Git.

  • If you use a project-level .cursor/mcp.json, consider adding it to .gitignore.

  • Rotate your token if it’s ever exposed.

Remove or disable 🚪

  • Go to Settings → Tools & Integrations → MCP Tools and toggle off XO-MCP-Server, or remove the JSON entry from your MCP config.

Made with ❤️ by the XO team. Happy building! ✨

PreviousIntegrationsNextChatgpt

Last updated