Blaxel Skills & MCP

Blaxel provides LLM-accessible tools that you can connect to your coding assistant (Cursor, Windsurf, Claude Desktop, etc.). There are several options:

The Blaxel agent skills let your coding agent autonomously create sandboxes, deploy agents, run jobs, and launch MCP servers on Blaxel using simple prompts, with support for both command-line (CLI) and code-driven (SDK) operations.
The Blaxel resource management MCP server lets your coding agent directly manage your Blaxel resources using natural language.
The Blaxel documentation MCP server lets your coding agent directly read and ask questions of this documentation in real-time for up-to-date commands and features.
An llms-full.txt text file with the entire documentation compiled and formatted for LLMs.
A native AI assistant built into this documentation portal.

Agent skills

Agent skills are instruction sets to extend coding agents with additional knowledge and tools. An agent can load these instructions into its context and use them to complete the tasks assigned to it. Blaxel offers open source agent skills to help coding agents autonomously spin up and manage sandboxes on Blaxel, and migrate sandbox code from other providers to Blaxel.

Blaxel skills

The open source Blaxel skills let agents:

create perpetual sandboxes on Blaxel to run code and execute commands
start application servers within sandboxes
generate URLs to preview applications running within sandboxes
create Agent Drives (shared filesystems) on Blaxel
create and deploy AI agents on Blaxel
create and deploy MCP servers on Blaxel
deploy and run batch jobs on Blaxel

Two skills are currently available:

The blaxel-cli skill lets coding agents create and manage Blaxel resources from the command line using the bl CLI.
The blaxel-sdk skill lets coding agents write code to create and manage Blaxel resources using the Blaxel SDKs.

Use the blaxel-cli skill when you’re troubleshooting, or bootstrapping a project on Blaxel. Use the blaxel-sdk skill when building agents or MCP servers on Blaxel, or when you need to programmatically manage Blaxel resources.

Add the Blaxel skills to your coding agent with the command below:

npx skills add blaxel-ai/agent-skills

You’ll be prompted to choose skills and select your coding agent and installation location. The Blaxel skills are also available as a ZIP file for use with Claude.

See examples of using the Blaxel skills in our announcement blog post.

Blaxel migration skill

The open source Blaxel migration skill gives agents the knowledge they need to migrate sandbox code from other providers to Blaxel. It is currently able to migrate sandbox code from Daytona, E2B and Modal. Add the Blaxel migration skill to your coding agent with the command below, depending on which sandbox provider you wish to migrate from:

# migrate from Daytona
npx skills add blaxel-ai/agent-migration-skills/daytona

# migrate from E2B
npx skills add blaxel-ai/agent-migration-skills/e2b

# migrate from Modal
npx skills add blaxel-ai/agent-migration-skills/modal

You’ll be prompted to select your coding agent and installation location. The Blaxel migration skill is also available as a ZIP file for use with Claude.

MCP servers

MCP server for resource management

Blaxel’s MCP server lets compatible AI apps (Codex, Cursor, Claude Code, Windsurf, etc.) manage your Blaxel resources using natural language. It is available as a remote hosted HTTP server. Talk with your preferred agent to:

Create new services
Follow what is happening on your infrastructure
Manage your users

How it works

The MCP server is hosted at https://api.blaxel.ai/v0/mcp. Clients connect over HTTPS and stream MCP messages. The server supports OAuth 2.1 sign-in and API key authentication.

OAuth

Use OAuth when your client supports it. Your client opens Blaxel sign-in in a browser and stores the resulting token. The server advertises its authorization server at https://signin.blaxel.ai. It supports PKCE with the S256 challenge method, dynamic client registration, Client ID Metadata Documents, and public clients. Requested scopes are openid, email, profile, and offline_access.

Authentication headers

For clients without OAuth support, provide your API key in the Authorization header. If your user has access to multiple workspaces, include the workspace header as well.

Required: Authorization: Bearer <APIKEY>
Optional (multi-workspace): X-Blaxel-Workspace: <WORKSPACE_NAME_OR_ID>

Store your API key in an environment variable. Do not commit it to a repository.

Installation

Codex

Add the hosted server. Codex detects OAuth support and starts the sign-in flow:

codex mcp add blaxel --url https://api.blaxel.ai/v0/mcp

To sign in again later, run:

codex mcp login blaxel

To use an API key instead, set it in your shell and reference it from ~/.codex/config.toml:

export BLAXEL_MCP_API_KEY="<APIKEY>"

[mcp_servers.blaxel]
url = "https://api.blaxel.ai/v0/mcp"
bearer_token_env_var = "BLAXEL_MCP_API_KEY"

Claude Code

Add the remote HTTP server to your Claude Code by running the following command:

claude mcp add --transport http blaxel https://api.blaxel.ai/v0/mcp

Then sign in:

claude mcp login blaxel

To use an API key instead, set the headers when you add the server:

claude mcp add --transport http blaxel https://api.blaxel.ai/v0/mcp \
  --header "Authorization: Bearer <APIKEY>" \
  --header "X-Blaxel-Workspace: <OPTIONAL_WORKSPACE>"

Cursor

Add the server to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "blaxel": {
      "url": "https://api.blaxel.ai/v0/mcp"
    }
  }
}

Open Cursor settings, select MCP, then connect blaxel. Cursor opens Blaxel sign-in. Cursor Agent users can start sign-in from a terminal:

cursor-agent mcp login blaxel

To use an API key instead, add the headers to the server entry:

{
  "mcpServers": {
    "blaxel": {
      "url": "https://api.blaxel.ai/v0/mcp",
      "headers": {
        "Authorization": "Bearer <APIKEY>",
        "X-Blaxel-Workspace": "<OPTIONAL_WORKSPACE>"
      }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "blaxel": {
      "url": "https://api.blaxel.ai/v0/mcp",
      "headers": {
        "Authorization": "Bearer <APIKEY>",
        "X-Blaxel-Workspace": "<OPTIONAL_WORKSPACE>"
      }
    }
  }
}

Goose

Add to ~/.config/goose/config.yaml:

extensions:
  blaxel-api:
    enabled: true
    type: streamable_http
    name: blaxel-api
    description: Blaxel API MCP Server
    uri: https://api.blaxel.ai/v0/mcp
    envs: {}
    env_keys: []
    headers:
      Authorization: Bearer <APIKEY>
      X-Blaxel-Workspace: <OPTIONAL_WORKSPACE>
    timeout: 300
    bundled: null
    available_tools: []

Selecting a workspace

Every tool accepts an optional workspace argument. Ask your client to use that argument when you want a tool to act on a specific workspace. If your account has multiple workspaces, you can also set the active workspace by including the X-Blaxel-Workspace header. If neither is set, your AI app may prompt you to specify one when a tool is invoked.

Example prompts

Ask your AI app to perform actions using Blaxel MCP tools, for example:

List my agents
Create a new MCP server named search with blaxel-search integration
Invite test@mydomain.com to my workspace

Supported actions

The Blaxel MCP server exposes tools for common platform operations. You can list, create and remove services (Sandboxes, Agents, MCP Servers, Jobs, Models, …), as well as manage users and service accounts. See the open-source definitions for the latest list and schemas.

Running locally

Prefer using the hosted server at https://api.blaxel.ai/v0/mcp. If you must run locally or customize behavior, clone the repository and follow its instructions.

Limitations

The server requires an OAuth sign-in or a valid API key.
When using multiple workspaces, set the workspace argument or the X-Blaxel-Workspace header to disambiguate.

Check out Blaxel MCP server’s source here.

MCP server for documentation

You can also give your coding assistant real-time access to this documentation. Connect your coding assistant directly to the Blaxel documentation via MCP at https://docs.blaxel.ai/mcp.

Claude Code

Add the remote HTTP server to your Claude Code by running the following command:

claude mcp add --transport http blaxel-docs https://docs.blaxel.ai/mcp

Cursor

Open Cursor Settings
Go to MCP & Integrations
Click ”+ Add a custom MCP server”
Add this configuration:

{
  "mcpServers": {
    ... // Your other MCP servers
    "blaxel-docs": {
      "url": "https://docs.blaxel.ai/mcp"
    }
  }
}

MCP server for sandboxes

Every Blaxel sandbox also exposes its own built-in MCP server, hosted via streamable HTTP at https://<SANDBOX_BASE_URL>/mcp, so agents can operate that specific sandbox directly.

MCP server hosting

Blaxel also lets you deploy and host your own MCP servers as serverless, autoscaling endpoints.

MCP endpoints at a glance

Surface	Endpoint pattern	Purpose	Persistence
Resource management	`https://api.blaxel.ai/v0/mcp`	Manage your Blaxel workspace (create/list/delete resources) from a coding assistant	Fixed platform endpoint
Documentation	`https://docs.blaxel.ai/mcp`	Give a coding assistant real-time access to this documentation	Fixed platform endpoint
Per deployed MCP server	`https://run.blaxel.ai/{workspace}/functions/{server-name}/mcp`	Call tools exposed by an MCP server deployed by you	Fixed so long as the function’s name is unchanged
Per deployed sandbox	`https://<SANDBOX_BASE_URL>/mcp`	Let an agent operate a sandbox deployed by you	Tied to the sandbox’s `name`; fixed across standby/resume.

llms-full.txt

A compiled text document of the entire documentation, formatted for LLMs. Copy and paste it directly into your coding assistant’s prompt: https://docs.blaxel.ai/llms-full.txt

Built-in documentation agent

This documentation portal has a built-in AI assistant. Click “✨Ask AI” at the top of any page to use it.

Get Started

Sandboxes

Agent Drive

Volumes

Batch Jobs

Applications

MCP Servers Hosting

Model Gateway

Observability

Integrations

Administration & security

Troubleshooting

Agent skills

Blaxel skills

Blaxel migration skill

MCP servers

MCP server for resource management

How it works

OAuth

Authentication headers

Installation

Codex

Claude Code

Cursor

Windsurf

Goose

Selecting a workspace

Example prompts

Supported actions

Running locally

Limitations

MCP server for documentation

Claude Code

Cursor

MCP server for sandboxes

MCP server hosting

MCP endpoints at a glance

llms-full.txt

Built-in documentation agent

​Agent skills

​Blaxel skills

​Blaxel migration skill

​MCP servers

​MCP server for resource management

​How it works

OAuth

Authentication headers

​Installation

Codex

Claude Code

Cursor

Windsurf

Goose

​Selecting a workspace

​Example prompts

​Supported actions

​Running locally

​Limitations

​MCP server for documentation

​Claude Code

​Cursor

​MCP server for sandboxes

​MCP server hosting

​MCP endpoints at a glance

​llms-full.txt

​Built-in documentation agent

Agent skills

Blaxel skills

Blaxel migration skill

MCP servers

MCP server for resource management

How it works

Installation

Selecting a workspace

Example prompts

Supported actions

Running locally

Limitations

MCP server for documentation

Claude Code

Cursor

MCP server for sandboxes

MCP server hosting

MCP endpoints at a glance

llms-full.txt

Built-in documentation agent