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
}
MCP Environment
Call Tools
Execute a specific tool with provided arguments
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
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
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
}