MCP Server

Active

AGPL-3.0

Coder MCP Server

io.github.coder/coder

Manage self-hosted cloud development environments and AI coding agents through Coder via MCP.

What is the Coder MCP server?

Coder is the MCP server for Coder, a self-hosted platform for cloud development environments and AI coding agents. It exposes Coder's workspace, template, and agent management functionality over a remote streamable-HTTP MCP endpoint, letting AI assistants provision, inspect, and control cloud development environments running on your own infrastructure.

Coder is a self-hosted platform that lets teams define cloud development environments (EC2 VMs, Kubernetes Pods, Docker containers, etc.) with Terraform templates, connect to them over a secure WireGuard tunnel, and auto-shutdown idle resources to save costs. It also supports running AI coding agents natively in the control plane, using any LLM provider without embedding credentials in workspaces. The Coder MCP server exposes this platform to MCP-compatible clients (like Claude or Cursor) via a remote streamable-http endpoint on your Coder deployment, allowing an AI agent to manage workspaces, templates, and environments through natural language rather than the CLI or web UI.

How to install Coder

Copy-paste configuration for popular MCP clients.

transport: http

Config generated by PluginBench — verify against the source before use.

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "coder": {
      "url": "https://{coder_hostname}/api/experimental/mcp/http"
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "coder": {
      "serverUrl": "https://{coder_hostname}/api/experimental/mcp/http"
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "coder": {
      "type": "http",
      "url": "https://{coder_hostname}/api/experimental/mcp/http"
    }
  }
}

Claude Desktop

Claude Desktop connects to remote servers via the mcp-remote bridge.

{
  "mcpServers": {
    "coder": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://{coder_hostname}/api/experimental/mcp/http"
      ]
    }
  }
}

Claude Code

claude mcp add --transport http coder https://{coder_hostname}/api/experimental/mcp/http

Use cases

Provision or tear down Coder workspaces defined by Terraform templates directly from an AI assistant
Delegate coding tasks to AI agents running on your own infrastructure without exposing LLM credentials to workspaces
Inspect and manage workspace templates for cloud development environments (EC2, Kubernetes, Docker)
Automate onboarding of developers into pre-configured cloud dev environments
Monitor and control idle/active workspaces to manage infrastructure costs

Coder MCP server FAQ

What does the Coder MCP server do?

It connects MCP-compatible AI clients to a running Coder deployment via a remote streamable-http endpoint (https://{coder_hostname}/api/experimental/mcp/http), giving the AI access to Coder's workspace, template, and agent management capabilities.

Is the Coder MCP server free?

Coder itself is open source and free to self-host; some advanced features are part of Coder Premium, a paid plan for larger teams. The MCP endpoint is part of the core Coder server.

What authentication does it require?

It requires a running, self-hosted Coder deployment; you connect to your own Coder hostname's MCP endpoint, and authentication follows Coder's own user/session model rather than API keys embedded in workspaces.

How do I connect this MCP server in Cursor or Claude?

Add the remote streamable-http endpoint https://{coder_hostname}/api/experimental/mcp/http (replacing {coder_hostname} with your Coder server's hostname) as an MCP server in your client's configuration; no local install of this specific server is needed beyond having a running Coder deployment.

Do I need to install anything else to use this?

Yes, you need a running Coder server, which you can install locally via the install script (curl -L https://coder.com/install.sh | sh) or deploy in production with a PostgreSQL database and external access URL.

Is this the same as the Coder CLI or VS Code extension?

No, this is a separate MCP HTTP endpoint exposed by the Coder server itself, distinct from the CLI, VS Code extension, or JetBrains plugins, though all interact with the same underlying Coder platform.

README (reference)

Source of truth, from the repository.

<div align="center"> <a href="https://coder.com#gh-light-mode-only"> <img src="./docs/images/logo-black.png" alt="Coder Logo Light" style="width: 128px"> </a> <a href="https://coder.com#gh-dark-mode-only"> <img src="./docs/images/logo-white.png" alt="Coder Logo Dark" style="width: 128px"> </a> <h1> Self-Hosted Cloud Development Environments and AI Agents </h1> <a href="https://coder.com#gh-light-mode-only"> <img src="./docs/images/banner-black.png" alt="Coder Banner Light" style="width: 650px"> </a> <a href="https://coder.com#gh-dark-mode-only"> <img src="./docs/images/banner-white.png" alt="Coder Banner Dark" style="width: 650px"> </a> <br> <br>

Quickstart | Docs | Why Coder | Premium

</div>

Coder is a self-hosted platform for cloud development environments and AI coding agents. Workspaces are defined with Terraform, connected through a secure Wireguard® tunnel, and automatically shut down when not used. Coder Agents runs a native AI coding agent whose loop executes in the control plane on your infrastructure, with no API keys in workspaces.

Define cloud development environments in Terraform
- EC2 VMs, Kubernetes Pods, Docker Containers, etc.
Automatically shutdown idle resources to save on costs
Onboard developers in seconds instead of days
Delegate coding work to AI agents on your infrastructure
- Bring any model (Anthropic, OpenAI, Google, Bedrock, self-hosted)
- No LLM credentials in workspaces, user identity on every action
- Centralized model governance, cost tracking, and audit logging

Quickstart

The most convenient way to try Coder is to install it on your local machine and experiment with provisioning cloud development environments using Docker (works on Linux, macOS, and Windows).

# First, install Coder
curl -L https://coder.com/install.sh | sh

# Start the Coder server (caches data in ~/.cache/coder)
coder server

# Navigate to http://localhost:3000 to create your initial user,
# create a Docker template and provision a workspace

Install

The easiest way to install Coder is to use the install script for Linux and macOS. For Windows, use the latest ..._installer.exe file from GitHub Releases.

curl -L https://coder.com/install.sh | sh

You can run the install script with --dry-run to see the commands that will be used to install without executing them. Run the install script with --help for additional flags.

See install for additional methods.

Once installed, you can start a production deployment with a single command:

# Automatically sets up an external access URL on *.try.coder.app
coder server

# Requires a PostgreSQL instance (version 13 or higher) and external access URL
coder server --postgres-url <url> --access-url <url>

Use coder --help to get a list of flags and environment variables. See the install guides for a complete tutorial.

Documentation

Browse the documentation or visit a specific section below:

Workspaces: Workspaces contain the IDEs, dependencies, and configuration information needed for software development
Templates: Templates are written in Terraform and describe the infrastructure for workspaces
Coder Agents: Delegate coding work to AI agents running on your self-hosted infrastructure
Administration: Learn how to operate Coder
Premium: Learn about paid features built for large teams
IDEs: Connect your existing editor to a workspace

Support

Feel free to open an issue if you have questions, run into bugs, or have a feature request.

Join our Discord to provide feedback on in-progress features and chat with the community using Coder!

Integrations

New integrations are always in progress. Open an issue to request one. Contributions are welcome in any official or community repository.

Official

Coder Registry: Templates, modules, and integrations for common development environments
VS Code Extension: Open any Coder workspace in VS Code with a single click
JetBrains Toolbox Plugin: Open any Coder workspace from JetBrains Toolbox with a single click
JetBrains Gateway Plugin: Open any Coder workspace in JetBrains Gateway with a single click
Dev Containers: Build development environments using devcontainer.json on Docker, Kubernetes, and OpenShift
Kubernetes Log Stream: Stream Kubernetes Pod events to the Coder startup logs
Self-Hosted VS Code Extension Marketplace: A private extension marketplace that works in restricted or airgapped networks integrating with code-server.
GitHub Actions: An action to set up the Coder CLI in GitHub workflows

Community

Community Templates: Community-contributed workspace templates in the Coder Registry
Community Modules: Community-contributed modules to extend Coder templates
Provision Coder with Terraform: Provision Coder on Google GKE, Azure AKS, AWS EKS, DigitalOcean DOKS, IBMCloud K8s, OVHCloud K8s, and Scaleway K8s Kapsule with Terraform
Coder Template GitHub Action: A GitHub Action that updates Coder templates
Discord: Chat with the community and provide feedback on in-progress features

Contributing

New contributors are always welcome. If you are new to the Coder codebase, see the contribution guide to get started.

Hiring

Apache-2.0

View repository →