Capsulate

Real Linux and Windows desktop VMs for AI agents: exec, files, computer-use and snapshots via MCP.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

One-click editor setup isn’t available for this listing yet — we don’t have a confirmed install command, and we’d rather show nothing than point your editor at the wrong package or host. Follow the project’s own setup instructions, linked above.

Manual Client & Custom JSON ConfigExpand JSON ▾

No confirmed setup config for this listing yet. We only publish a config block when the install details come from the project itself — its README, its docs, or a verified owner. We haven’t found those for capsulate, and we’d rather show nothing than a guess you’d paste into your client. Follow the project’s own setup instructions for the current steps.

Documentation Overview

Capsulate

Real computers for AI agents. A capsule is a full KVM virtual machine, Linux headless, Linux desktop, or Windows Server desktop for invited testers, taken from a warm pool in about two seconds. Your agent gets exec, files, screenshots, the OS accessibility tree (AT-SPI on Linux, UIAutomation on Windows), checkpoint and rollback of the whole machine, and session replay.

This repository is the doorway: everything a developer installs to talk to Capsulate. It is MIT licensed. The engine (the control plane and the node agent) runs on our metal in Helsinki and is not in this repository.

Package	What it is	Install
`@capsulate/sdk`	TypeScript client, zero dependencies	`npm i @capsulate/sdk`
`@capsulate/cli`	The `cap` command line	`npm i -g @capsulate/cli`
`@capsulate/mcp`	MCP server for Claude Desktop, Cursor and any MCP client	`npx -y @capsulate/mcp`
`@capsulate/ai-tools`	Tool packs for the Vercel AI SDK and LangChain	`npm i @capsulate/ai-tools`
`run-action`	GitHub Action: run a step inside a capsule	`uses: capsulatedev/run-action@v1`

Quickstart

You need an API key from the dashboard (Settings, API and Keys). Capsulate is in a private beta; request access at capsulate.dev.

Terminal

npm i -g @capsulate/cli
cap login --api-key cap_live_...
cap launch -t ubuntu-desktop -s 1c2g --wait
cap exec <id> -- python3 -c "print(6 * 7)"
cap shot <id> -o frame.png
cap capsule destroy <id>

Or from TypeScript:

server.ts

import { Capsulate } from "@capsulate/sdk";

const cap = new Capsulate({ apiKey: process.env.CAPSULATE_API_KEY });
const box = await cap.capsules.launch({ template: "ubuntu-desktop", size: "1c2g" });
await box.waitUntilActive();
await box.exec(["python3", "main.py"]);
await box.findAndClick({ name: "Save" });        // find the control by name, act, verify
const cp = await box.checkpoint("before-submit"); // whole machine, under a second
await box.destroy();

More in examples/ and at docs.capsulate.dev.

Sizes and pricing

Machines are metered per second. The beta is free; the published rates are on the pricing page. Limits and known issues are listed honestly at docs.capsulate.dev/limits: one compute node in Helsinki today, about ten to fifteen capsules active at the same time, Windows for invited testers only.

Developing

Terminal

npm ci
npm run build:sdk    # the CLI, MCP server and tool packs typecheck against the built SDK types
npm run typecheck
npm run build

npm run build builds the SDK first, then the tool packs, the CLI and the MCP server.

Security

Report vulnerabilities to security@capsulate.dev (see SECURITY.md). Never put a real cap_live_ key in an issue.

License

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Capsulate

We don't have a confirmed install command for capsulate yet, so we don't publish a generated one — a guessed package name would point at the wrong package or none at all. Follow the project's own README or setup instructions (https://github.com/capsulatedev/capsulate) for the current steps.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/capsulate?style=directory)](https://allmcps.com/mcp/capsulate)

HTML Embed

<a href="https://allmcps.com/mcp/capsulate"><img src="https://allmcps.com/api/badge/capsulate?style=directory" alt="Capsulate on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Featured

AllMCPs Server

The official MCP server for AllMCPs.com - submit and manage tools directly from your AI. The open directory for MCP servers. Connect Claude, Cursor, Windsurf, and AI agents to databases, tools, files, and APIs. Explore 10,000+ servers. AllMCPs is the premier, open directory for discovering, evaluating, and installing Model Context Protocol (MCP) servers to equip AI agents and LLMs with real-world superpowers.

Explore Server →

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Capsulate →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Documentation Overview

Capsulate

Package	What it is	Install
`@capsulate/sdk`	TypeScript client, zero dependencies	`npm i @capsulate/sdk`
`@capsulate/cli`	The `cap` command line	`npm i -g @capsulate/cli`
`@capsulate/mcp`	MCP server for Claude Desktop, Cursor and any MCP client	`npx -y @capsulate/mcp`
`@capsulate/ai-tools`	Tool packs for the Vercel AI SDK and LangChain	`npm i @capsulate/ai-tools`
`run-action`	GitHub Action: run a step inside a capsule	`uses: capsulatedev/run-action@v1`

Quickstart

You need an API key from the dashboard (Settings, API and Keys). Capsulate is in a private beta; request access at capsulate.dev.

Terminal

npm i -g @capsulate/cli
cap login --api-key cap_live_...
cap launch -t ubuntu-desktop -s 1c2g --wait
cap exec <id> -- python3 -c "print(6 * 7)"
cap shot <id> -o frame.png
cap capsule destroy <id>

Or from TypeScript:

server.ts

import { Capsulate } from "@capsulate/sdk";

const cap = new Capsulate({ apiKey: process.env.CAPSULATE_API_KEY });
const box = await cap.capsules.launch({ template: "ubuntu-desktop", size: "1c2g" });
await box.waitUntilActive();
await box.exec(["python3", "main.py"]);
await box.findAndClick({ name: "Save" });        // find the control by name, act, verify
const cp = await box.checkpoint("before-submit"); // whole machine, under a second
await box.destroy();

More in examples/ and at docs.capsulate.dev.

Sizes and pricing

Developing

Terminal

npm ci
npm run build:sdk    # the CLI, MCP server and tool packs typecheck against the built SDK types
npm run typecheck
npm run build

npm run build builds the SDK first, then the tool packs, the CLI and the MCP server.

Security

Report vulnerabilities to security@capsulate.dev (see SECURITY.md). Never put a real cap_live_ key in an issue.

License

Frequently Asked Questions about Capsulate