For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Dashboard
User GuideDeveloper GuidesAPI Reference
User GuideDeveloper GuidesAPI Reference
    • Overview
  • Runtype API
      • GETMCP manifest
      • GETOAuth protected resource metadata
      • GETMCP surface info
      • POSTExecute an MCP surface tool (dashboard test)
      • POSTList MCP surface tools (dashboard test)
Dashboard
LogoLogo
Runtype APIProduct Mcp

List MCP surface tools (dashboard test)

POST
/v1/products/:productId/surfaces/:surfaceId/mcp/tools/test
POST
/v1/products/:productId/surfaces/:surfaceId/mcp/tools/test
$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}

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

Was this page helpful?
Previous

List prompts

Next
Built with

Authentication

AuthorizationBearer
API key or Clerk session token

Path parameters

productIdstringRequired
surfaceIdstringRequired

Response

Available tools for the surface
successboolean
surfaceobject
toolslist of objects

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error