{ "openapi": "3.0.1", "info": { "title": "MCP Server Governance & Change Monitor", "description": "Monitor approved MCP servers in the official MCP Registry. Detect version, package, endpoint, transport, auth and lifecycle changes.", "version": "0.1", "x-build-id": "dKGRzRJjWA37QNLST" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automa-flow~mcp-server-governance-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automa-flow-mcp-server-governance-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/automa-flow~mcp-server-governance-monitor/runs": { "post": { "operationId": "runs-sync-automa-flow-mcp-server-governance-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/automa-flow~mcp-server-governance-monitor/run-sync": { "post": { "operationId": "run-sync-automa-flow-mcp-server-governance-monitor", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "mode": { "title": "Mode", "enum": [ "watchlist", "registryChanges" ], "type": "string", "description": "Watchlist looks up each exact server name (one Registry request per server). Registry changes pages through servers the official Registry marks as updated since the previous successful checkpoint of this monitorKey, latest version only.", "default": "watchlist" }, "monitorKey": { "title": "Monitor key", "minLength": 1, "maxLength": 80, "type": "string", "description": "Independent state namespace. Use a stable name per watch, for example production-approved. Letters, numbers, '_' and '-', 1-80 characters.", "default": "default" }, "servers": { "title": "Servers to watch", "minItems": 0, "maxItems": 500, "type": "array", "description": "Exact official Registry names such as io.github.github/github-mcp-server, 1-500, required in watchlist mode. No fuzzy matching: a name the Registry does not know is NOT_FOUND. Duplicates keep the first entry. Ignored in registryChanges mode (reported as watchlistIgnored in the run summary).", "items": { "type": "string" } }, "changesOnly": { "title": "Changes only", "type": "boolean", "description": "Omit UNCHANGED observations from the Dataset; successful unchanged checks are still billed. BASELINE rows follow the First observation setting. NOT_FOUND, FAILED and typed changes are delivered.", "default": true }, "baselineMode": { "title": "First observation", "enum": [ "emitSnapshot", "storeOnly" ], "type": "string", "description": "Emit snapshot writes a BASELINE row the first time a server is seen in this monitorKey. Store only records the baseline silently and starts emitting from the second run.", "default": "emitSnapshot" }, "includeDeleted": { "title": "Include deleted servers", "type": "boolean", "description": "Ask the Registry to include servers with official status deleted, so a deletion is reported as SERVER_DELETED with the Registry's own status. When off, a deleted server is invisible to the lookup and reported as NOT_FOUND.", "default": true }, "maxResults": { "title": "Max servers per registryChanges run", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Upper bound on unique server observations in one registryChanges run (1-5000). Larger windows return PARTIAL and save a continuation position. Run again with the same monitorKey to continue; the checkpoint advances after the complete window is verified.", "default": 1000 }, "lookbackDays": { "title": "First-run lookback (days)", "minimum": 1, "maximum": 30, "type": "integer", "description": "registryChanges only: how far back the very first run of a monitorKey looks (1-30). Later runs continue from the last successful checkpoint. One day held about 600 updated servers on 2026-09-13; seven days about 5,900.", "default": 1 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }