List MCP surface tools (dashboard test)

POST

/v1/products/:productId/surfaces/:surfaceId/mcp/tools/test

Dashboard test endpoint. Authenticates with a Clerk session JWT (not MCP API keys) and returns the available tools for the surface.

AuthorizationBearer

API key or Clerk session token

productIdstringRequired

surfaceIdstringRequired

Available tools for the surface

successboolean

surfaceobject

toolslist of objects

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/test \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{}'

1	{
2	"success": true,
3	"surface": {
4	"id": "surf_987654321",
5	"name": "Main Dashboard Surface",
6	"status": "active"
7	},
8	"tools": [
9	{
10	"description": "Tool for analyzing user engagement metrics on the surface.",
11	"name": "Engagement Analyzer"
12	},
13	{
14	"description": "Tool to monitor real-time data streams and alerts.",
15	"name": "Live Data Monitor"
16	}
17	]
18	}