> ## 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 Skills & MCP

> Configure Cursor, Claude Code, or other AI coding assistants to manage your Blaxel resources or access the Blaxel documentation.

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](https://agentskills.io/specification) 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](https://github.com/blaxel-ai/agent-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.

<Tip>
  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.
</Tip>

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

```shell theme={null}
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](https://github.com/blaxel-ai/agent-skills/releases) for [use with Claude](https://support.claude.com/en/articles/12512180-use-skills-in-claude).

<Tip>
  See [examples of using the Blaxel skills](https://blaxel.ai/blog/give-your-coding-agent-blaxel-superpowers) in our announcement blog post.
</Tip>

### Blaxel migration skill

The open source [Blaxel migration skill](https://github.com/blaxel-ai/agent-migration-skills) 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:

```shell theme={null}
# 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](https://github.com/blaxel-ai/agent-migration-skills/releases) for [use with Claude](https://support.claude.com/en/articles/12512180-use-skills-in-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](Security/Access-tokens) 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](https://docs.anthropic.com/en/docs/claude-code/mcp#option-3%3A-add-a-remote-http-server) by running the following command:

```bash theme={null}
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`:

```json theme={null}
{
  "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`:

```json theme={null}
{
  "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`:

```yaml theme={null}
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](mailto: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](https://github.com/blaxel-ai/blaxel-mcp-server) 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](https://github.com/blaxel-ai/blaxel-mcp-server).

### 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](https://docs.anthropic.com/en/docs/claude-code/mcp#option-3%3A-add-a-remote-http-server) by running the following command:

```bash theme={null}
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:

```json theme={null}
{
  "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](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.