Create MCP Box

curl --request POST \
  --url https://api.continuouslabs.ai/v1/mcpbox \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "apibox_id": "abx_01J8Z5X4K70000000000000001",
  "snapshot_id": "mbs_01J8Z5X4K70000000000000007"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.continuouslabs.ai/v1/mcpbox"

	payload := strings.NewReader("{\n  \"apibox_id\": \"abx_01J8Z5X4K70000000000000001\",\n  \"snapshot_id\": \"mbs_01J8Z5X4K70000000000000007\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

import requests

url = "https://api.continuouslabs.ai/v1/mcpbox"

payload = {
    "apibox_id": "abx_01J8Z5X4K70000000000000001",
    "snapshot_id": "mbs_01J8Z5X4K70000000000000007"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    apibox_id: 'abx_01J8Z5X4K70000000000000001',
    snapshot_id: 'mbs_01J8Z5X4K70000000000000007'
  })
};

fetch('https://api.continuouslabs.ai/v1/mcpbox', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "mcpbox": {
    "apibox_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "endpoint": "<string>",
    "error": {
      "agent_message": "<string>",
      "code": "build_failed",
      "detail": "<string>",
      "reason": "canceled",
      "validation": {
        "issues": [
          {
            "code": "<string>",
            "kind": "invalid",
            "location": "<string>",
            "message": "<string>",
            "operation": "<string>",
            "suggestion": "<string>"
          }
        ]
      }
    },
    "id": "<string>",
    "metadata": "<unknown>",
    "name": "<string>",
    "snapshot_id": "<string>",
    "status": "starting"
  },
  "token": "<string>"
}

MCP Boxes

Create MCP Box

Creates an MCP Box that serves an MCP Box Snapshot’s tools over MCP in front of an API Box, and starts it. The API Box must be in the workspace and started from the API Box Snapshot the MCP Box Snapshot was built against. It returns at once with status starting and the MCP Box’s token; get the MCP Box until it is running. Send MCP requests to its endpoint followed by /mcp, with the token in X-Continuous-MCPBox-Token. The MCP Box keeps no state: its tools read and change the API Box, and a tool call while the API Box is stopped returns the API Box’s refusal as a tool error.

POST

https://api.continuouslabs.ai

/

v1

/

mcpbox

Create MCP Box

curl --request POST \
  --url https://api.continuouslabs.ai/v1/mcpbox \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "apibox_id": "abx_01J8Z5X4K70000000000000001",
  "snapshot_id": "mbs_01J8Z5X4K70000000000000007"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.continuouslabs.ai/v1/mcpbox"

	payload := strings.NewReader("{\n  \"apibox_id\": \"abx_01J8Z5X4K70000000000000001\",\n  \"snapshot_id\": \"mbs_01J8Z5X4K70000000000000007\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

import requests

url = "https://api.continuouslabs.ai/v1/mcpbox"

payload = {
    "apibox_id": "abx_01J8Z5X4K70000000000000001",
    "snapshot_id": "mbs_01J8Z5X4K70000000000000007"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    apibox_id: 'abx_01J8Z5X4K70000000000000001',
    snapshot_id: 'mbs_01J8Z5X4K70000000000000007'
  })
};

fetch('https://api.continuouslabs.ai/v1/mcpbox', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "mcpbox": {
    "apibox_id": "<string>",
    "created_at": "2023-11-07T05:31:56Z",
    "endpoint": "<string>",
    "error": {
      "agent_message": "<string>",
      "code": "build_failed",
      "detail": "<string>",
      "reason": "canceled",
      "validation": {
        "issues": [
          {
            "code": "<string>",
            "kind": "invalid",
            "location": "<string>",
            "message": "<string>",
            "operation": "<string>",
            "suggestion": "<string>"
          }
        ]
      }
    },
    "id": "<string>",
    "metadata": "<unknown>",
    "name": "<string>",
    "snapshot_id": "<string>",
    "status": "starting"
  },
  "token": "<string>"
}

Authorizations

Authorization

string

header

required

Use a Continuous API key. Send it in the Authorization header as a Bearer token.

Headers

Idempotency-Key

string

Optional key for retrying this create safely. A retry with the same key and request returns the same MCP Box and token. The same key with a different request returns 409 idempotency_conflict.

Maximum string length: 256

Body

application/json

apibox_id

string

required

An API Box of the workspace, started from the API Box Snapshot the MCP Box Snapshot was built against.

Pattern: ^abx_[0-9A-HJKMNP-TV-Z]{26}$

snapshot_id

string

required

An MCP Box Snapshot of the workspace.

Pattern: ^mbs_[0-9A-HJKMNP-TV-Z]{26}$

metadata

any

Customer JSON metadata, up to 16 KiB and 64 nesting levels.

name

string

Name for the MCP Box. Omission generates a name.

Maximum string length: 128

Response

Accepted

mcpbox

object

required

The MCP Box.

Show child attributes

token

string | null

required

The MCP Box's token, which lasts until the MCP Box is deleted. It is null only on a retried create whose first attempt stored no token; a start then issues one.