Skip to main content

​
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 Skill

The open source Blaxel Skill lets agents:
  • create perpetual sandboxes on Blaxel to run code and execute commands
  • start applications servers within sandboxes
  • generate URLs to preview applications running within sandboxes
  • create and deploy AI agents on Blaxel
  • create and deploy MCP servers on Blaxel
  • deploy and run batch jobs on Blaxel
Add the Blaxel Skill to your coding agent with the command below: 
npx skills add blaxel-ai/agent-skills
You’ll be prompted to select your coding agent and installation location. The Blaxel Skill is also available as a ZIP file for use with Claude.
See examples of using the Blaxel Skill 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 server

Blaxel’s MCP server lets compatible AI apps (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 HTTP(S) and stream MCP messages. Authentication is provided via headers.

​
Authentication headers

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>

​
Installation

​
Cursor

Add the server to ~/.cursor/mcp.json: 
{
  "mcpServers": {
    "blaxel": {
      "url": "https://api.blaxel.ai/v0/mcp",
      "headers": {
        "Authorization": "Bearer <APIKEY>",
        "X-Blaxel-Workspace": "<OPTIONAL_WORKSPACE>"
      }
    }
  }
}

​
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 \
  --header "Authorization: Bearer <APIKEY>" \
  --header "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: []

​
Using the MCP server

​
Selecting a workspace

If your account has multiple workspaces, set the active workspace by including the X-Blaxel-Workspace header. If omitted, 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 a valid API key.
  • When using multiple workspaces, X-Blaxel-Workspace must be provided to disambiguate.
Check out Blaxel MCP server’s source here.
Last modified on March 26, 2026