Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.blaxel.ai/llms.txt

Use this file to discover all available pages before exploring further.

Blaxel provides LLM-accessible tools that you can connect to your coding assistant (Cursor, Windsurf, Claude Desktop, etc.). There are several options:
  1. 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.
  2. The Blaxel resource management MCP server lets your coding agent directly manage your Blaxel resources using natural language.
  3. 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.
  4. An llms-full.txt text file with the entire documentation compiled and formatted for LLMs.
  5. 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 (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

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>"
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>"
      }
    }
  }
}
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

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.

​
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

  1. Open Cursor Settings
  2. Go to MCP & Integrations
  3. Click ”+ Add a custom MCP server”
  4. Add this configuration:
{
  "mcpServers": {
    ... // Your other MCP servers
    "blaxel-docs": {
      "url": "https://docs.blaxel.ai/mcp"
    }
  }
}

​
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.
Last modified on May 14, 2026