Skip to main content
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
}
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

​
image
string
required
Docker image identifier for the MCP environment. Contact Scale to obtain the image.
​
tags
object
required
Session scope tags for data isolation
​
toolName
string
required
Name of the tool to call (e.g., add_calendar_event)
​
toolArguments
object
required
Arguments to pass to the tool. Structure depends on the specific tool’s input schema.

​
Response

​
content
array
Array of content objects returned by the tool
​
isError
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
}