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
      • GETList discovered WebMCP tools
      • GETList observed page origins
      • GETList surfaces
Dashboard
LogoLogo
Runtype APISurfaces

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.

Was this page helpful?
Previous

List observed page origins

Next
Built with

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