Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.latitude.sh/docs/llms.txt

Use this file to discover all available pages before exploring further.

The Latitude.sh MCP server enables AI agents to access the Latitude.sh API through natural language. Manage your bare metal infrastructure directly from chat-based IDEs.

MCP server repository

​
What you can do

  • 🔎 List and inspect servers, projects, and SSH keys
  • ⚙️ Create or delete bare-metal instances
  • 📡 Manage networking and automation

​
Prerequisites

Before installing the MCP server, you’ll need an API key from your dashboard.

​
Installation

​
Claude Desktop

The easiest way to get started is using the DXT installer:
  1. Download mcp-server.dxt from the GitHub releases
  2. Drag and drop the file onto Claude Desktop
  3. The server will be automatically configured
Alternatively, manually configure in claude_desktop_config.json: 
{
  "mcpServers": {
    "latitudesh": {
      "command": "npx",
      "args": ["latitudesh", "start", "--bearer", "YOUR_LATITUDE_API_TOKEN"]
    }
  }
}

​
Claude Code CLI

claude mcp add latitudesh npx latitudesh start -- --bearer YOUR_LATITUDE_API_TOKEN

​
Cursor

  1. Open Settings → Tools and Integrations → New MCP Server
  2. Paste the following configuration:
{
  "mcpServers": {
    "latitudesh": {
      "command": "npx",
      "args": ["latitudesh", "start", "--bearer", "YOUR_LATITUDE_API_TOKEN"]
    }
  }
}

​
VS Code (Copilot)

  1. Open Command Palette and run “MCP: Open User Configuration”
  2. Add the server configuration:
{
  "servers": {
    "latitudesh": {
      "command": "npx",
      "args": ["latitudesh", "start", "--bearer", "YOUR_LATITUDE_API_TOKEN"]
    }
  }
}
  1. Restart VS Code and enable Agent mode in Copilot Chat
Be explicit in your prompts (e.g., “List my servers from Latitude.sh”) to avoid local file searches.

​
Windsurf

  1. Go to Settings → Cascade → Manage MCPs → View raw config
  2. Add the server configuration:
{
  "mcpServers": {
    "latitudesh": {
      "command": "npx",
      "args": ["latitudesh", "start", "--bearer", "YOUR_LATITUDE_API_TOKEN"]
    }
  }
}

​
Standalone CLI

Run the MCP server directly from the command line: 
npx latitudesh start --bearer YOUR_LATITUDE_API_TOKEN
Optional flags:
  • --server-index <0|1> — API endpoint selection
  • --latitude-api-key <key> — URL templating
  • --log-level <level> — Logging verbosity (debug|warning|info|error)

​
Development

To run the MCP server locally for development: 
# Clone the repository
git clone https://github.com/latitudesh/latitudesh-mcp.git
cd latitudesh-mcp

# Install dependencies
npm install

# Build
npm run build

# Run
node ./bin/mcp-server.js start --bearer YOUR_LATITUDE_API_TOKEN

​
Testing with MCP Inspector

Use the MCP Inspector for local testing and debugging: 
npx @modelcontextprotocol/inspector node ./bin/mcp-server.js start --bearer YOUR_LATITUDE_API_TOKEN
This opens an interactive UI at http://localhost:6274

​
Contributing

The Latitude.sh MCP server is open source and welcomes contributions. Visit the GitHub repository to open issues or submit pull requests.