Call Tools

curl -X POST http://localhost:3004/call-tools \
  -H "Content-Type: application/json" \
  -d '{
    "image": "agent-environment:latest",
    "tags": {"assignmentId": "my-test-session"},
    "toolName": "add_calendar_event",
    "toolArguments": {
      "title": "Team Meeting",
      "start_time": 1735689600,
      "end_time": 1735693200
    }
  }'

{
  "content": [
    {
      "type": "text",
      "text": "Successfully created calendar event 'Team Meeting' with ID: evt_abc123"
    }
  ],
  "isError": false
}

{
  "content": [
    {
      "type": "text",
      "text": "Error: Invalid timestamp format. Expected Unix timestamp (integer)."
    }
  ],
  "isError": true
}

POST

call-tools

curl -X POST http://localhost:3004/call-tools \
  -H "Content-Type: application/json" \
  -d '{
    "image": "agent-environment:latest",
    "tags": {"assignmentId": "my-test-session"},
    "toolName": "add_calendar_event",
    "toolArguments": {
      "title": "Team Meeting",
      "start_time": 1735689600,
      "end_time": 1735693200
    }
  }'

{
  "content": [
    {
      "type": "text",
      "text": "Successfully created calendar event 'Team Meeting' with ID: evt_abc123"
    }
  ],
  "isError": false
}

{
  "content": [
    {
      "type": "text",
      "text": "Error: Invalid timestamp format. Expected Unix timestamp (integer)."
    }
  ],
  "isError": true
}

Execute a specific MCP tool with the provided arguments. The tool will run within the isolated session defined by your tags.

Contact Scale to receive Docker images for your environments.

Request Body

string

required

Docker image identifier for the MCP environment. Contact Scale to obtain the image.

object

required

Session scope tags for data isolation

Show properties

string

Unique session identifier for data isolation

string

required

Name of the tool to call (e.g., add_calendar_event)

object

required

Arguments to pass to the tool. Structure depends on the specific tool’s input schema.

Response

array

Array of content objects returned by the tool

Show properties

string

Content type (typically text)

string

The text content of the response

boolean

Whether the tool call resulted in an error

curl -X POST http://localhost:3004/call-tools \
  -H "Content-Type: application/json" \
  -d '{
    "image": "agent-environment:latest",
    "tags": {"assignmentId": "my-test-session"},
    "toolName": "add_calendar_event",
    "toolArguments": {
      "title": "Team Meeting",
      "start_time": 1735689600,
      "end_time": 1735693200
    }
  }'

{
  "content": [
    {
      "type": "text",
      "text": "Successfully created calendar event 'Team Meeting' with ID: evt_abc123"
    }
  ],
  "isError": false
}

{
  "content": [
    {
      "type": "text",
      "text": "Error: Invalid timestamp format. Expected Unix timestamp (integer)."
    }
  ],
  "isError": true
}

⌘I

Overview

Website Environments

Desktop Environments

MCP Environment

Request Body

Response

​Request Body

​Response

Request Body

Response