List discovered WebMCP tools

GET

/v1/products/:productId/surfaces/:surfaceId/discovered-tools

GET

/v1/products/:productId/surfaces/:surfaceId/discovered-tools

$ curl https://api.runtype.com/v1/products/productId/surfaces/surfaceId/discovered-tools \
>      -H "Authorization: <apiKey>" \
>      -H "Content-Type: application/json"

1 {
2   "origins": [
3     {
4       "requestOrigin": "https://chatapp.example.com",
5       "tools": [
6         {
7           "description": "Real-time sentiment analysis tool for chat messages",
8           "firstSeenAt": "2024-06-10T08:15:30Z",
9           "lastSeenAt": "2024-06-16T17:45:00Z",
10           "parametersSchema": {
11             "language": "en",
12             "sensitivity": "medium"
13           },
14           "reportedPageOrigin": "https://chatapp.example.com/dashboard",
15           "source": "observed",
16           "status": "admitted",
17           "toolName": "SentimentAnalyzerV2"
18         }
19       ]
20     }
21   ],
22   "windowDays": 7
23 }

List the WebMCP page tools observed on this chat surface over the trailing 7 days, grouped by validated request origin. Each tool carries a live admit/reject status derived from the surface’s current behavior.webmcp allowlist (never stored). Client-reported pageOrigin is returned as diagnostic metadata only.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

productIdstringRequired

surfaceIdstringRequired

Response

Discovered WebMCP tools grouped by request origin

originslist of objects

windowDaysdouble

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error