Overview

The document contains information about the XO MCP, you can also refer XO MCP official repository on Github: https://github.com/sharmasuraj0123/xo-mcp-server/blob/main/README.md

XO MCP Server

A powerful Model Context Protocol (MCP) server that provides seamless integration with the XO platform for container deployment, application lifecycle management, and knowledge base operations. This server enables AI assistants to deploy, manage, and interact with applications on the XO infrastructure through natural language commands.

🚀 Features

Container Deployment & Management

  • One-click deployment to XO platform

  • Lifecycle management (start, stop, remove applications)

  • Real-time logging and monitoring

  • Application exposure with automatic domain provisioning

Knowledge Base Integration

  • Dynamic knowledge base updates using text content

  • Intelligent question answering with context-aware responses

  • Multi-project support with isolated knowledge bases

  • Flexible agent types for different use cases

Developer Experience

  • Simple setup with environment-based configuration

  • Comprehensive error handling with detailed feedback

  • Modern MCP architecture using FastMCP

  • Cross-platform compatibility

📋 Prerequisites

  • Python 3.11 or higher

  • uv package manager

  • XO platform account with valid credentials

  • MCP-compatible client (Claude Desktop, Cursor, etc.)

🛠️ Installation

Option 1: Direct from GitHub (Recommended)

Add this configuration to your MCP client settings:

{
  "mcpServers": {
    "xo-mcp-server": {
      "command": "uvx",
      "args": [
        "git+https://github.com/sharmasuraj0123/xo-mcp-server.git"
      ],
      "env": {
        "ACCESS_TOKEN": "your_access_token",
        "DEPLOYMENT_ID": "your_deployment_id"
      }
    }
  }
}

Option 2: Local Development

  1. Clone the repository:

git clone https://github.com/sharmasuraj0123/xo-mcp-server.git
cd xo-mcp-server

  1. Add to your MCP client settings:

{
  "mcpServers": {
    "xo-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/xo-mcp-server",
        "run",
        "-m",
        "xo_mcp_server"
      ],
      "env": {
        "ACCESS_TOKEN": "your_access_token",
        "DEPLOYMENT_ID": "your_deployment_id"
      }
    }
  }
}

⚙️ Configuration

Environment Variables

Variable
Description
Required

ACCESS_TOKEN

Your XO platform access token

✅

DEPLOYMENT_ID

Unique deployment identifier from XO Launchpad

✅

Getting Your Credentials

  1. Visit XO Launchpad

  2. Login and create a new project

  3. Note down your DEPLOYMENT_ID

  4. Contact the XO team for your ACCESS_TOKEN

🔧 Available Tools

Container Management

deploy_to_xo()

Deploy your containerized application to the XO platform.

Usage: "Deploy my application to XO"

start_xo_app()

Start a previously deployed application.

Usage: "Start my XO application"

stop_xo_app()

Stop a running application without removing it.

Usage: "Stop my XO application"

remove_xo_app()

Completely remove an application from the platform.

Usage: "Remove my XO application"

get_xo_app_logs()

Retrieve real-time logs from your running application.

Usage: "Show me the logs for my XO app"

expose_xo_app()

Expose your application to the internet with a custom domain.

Usage: "Expose my XO app to the internet"

Knowledge Base Operations

update_knowledgebase_using_text(project_name, text_content, text_id?)

Add or update text content in your project's knowledge base.

Parameters:

  • project_name (string): Name of your XO project

  • text_content (string): The text content to add/update

  • text_id (string, optional): Unique identifier for the text content

Usage: "Update my knowledge base with this documentation"

ask_question(project_name, question, user_id?, agent_type?, message_type?)

Query your project's knowledge base with intelligent responses.

Parameters:

  • project_name (string): Name of your XO project

  • question (string): Your question

  • user_id (string, optional): User identifier (default: "default_user")

  • agent_type (string, optional): Type of agent response (default: "normal")

  • message_type (string, optional): Message type (default: "@xo")

Usage: "Ask my knowledge base about deployment procedures"

🏗️ Architecture

The XO MCP Server is built on the FastMCP framework and provides:

  • RESTful API integration with XO backend services

  • Robust error handling with detailed error messages

  • Environment-based configuration for security

  • Modular tool architecture for easy extension

🤝 Contributing

  1. Fork the repository

  2. Create a feature branch: git checkout -b feature/amazing-feature

  3. Commit your changes: git commit -m 'Add amazing feature'

  4. Push to the branch: git push origin feature/amazing-feature

  5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

🔗 Related Projects

Built with ❤️ by the XO team

PreviousXO MCP ServerNextIntegrations

Last updated