Execute an MCP surface tool (dashboard test)

Dashboard test endpoint. Authenticates with a Clerk session JWT and executes a named tool via the same path as production tools/call.

AuthorizationBearer

API key or Clerk session token

productIdstringRequired

surfaceIdstringRequired

This endpoint expects an object.

toolNamestringRequired

argumentsmap from strings to anyOptional

Tool execution result

durationdouble

isErrorboolean

successboolean

textstring

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/products/productId/surfaces/surfaceId/mcp/tools/execute-test \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"toolName": "dataValidationTool"
>	}'

1	{
2	"duration": 0.85,
3	"isError": false,
4	"success": true,
5	"text": "Tool executed successfully with no errors."
6	}

$	curl -X POST https://api.runtype.com/v1/products/productId/surfaces/surfaceId/mcp/tools/execute-test \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"toolName": "dataValidationTool"
>	}'

1	{
2	"duration": 0.85,
3	"isError": false,
4	"success": true,
5	"text": "Tool executed successfully with no errors."
6	}