Skip to main content
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.