{ "openapi": "3.0.1", "info": { "title": "Docs MCP Server Starter — Live Docs: Claude, Cursor & AI Agents", "description": "Persistent MCP server that gives Claude, Cursor, and any MCP-compatible AI assistant queryable access to technical documentation. Indexes any docs site, exposes search and fetch tools over MCP, caches pages for speed. Ships with templates for Next.js, Tailwind, React, TypeScript, Prisma.", "version": "0.2", "x-build-id": "GmHZp7hlXwEdwY8go" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/joeslade~docs-mcp-server-starter/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-joeslade-docs-mcp-server-starter", "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/joeslade~docs-mcp-server-starter/runs": { "post": { "operationId": "runs-sync-joeslade-docs-mcp-server-starter", "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/joeslade~docs-mcp-server-starter/run-sync": { "post": { "operationId": "run-sync-joeslade-docs-mcp-server-starter", "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": { "sources": { "title": "Documentation sources", "maxItems": 10, "type": "array", "description": "Documentation sources to index on startup. Use a curated template ID (nextjs, tailwind, react, typescript, prisma) or provide a custom url + contentSelector for any docs site. Each source needs a unique name.", "items": { "type": "object", "required": [ "name" ], "properties": { "name": { "title": "Source name", "type": "string", "description": "Unique label for this source (e.g., \"Next.js Docs\"). Used as the lookup key in MCP tool calls." }, "template": { "title": "Template ID", "type": "string", "description": "Curated template ID: nextjs, tailwind, react, typescript, or prisma. Use this OR url + contentSelector." }, "url": { "title": "Custom URL", "type": "string", "description": "Entry URL for a custom docs site (e.g., https://docs.example.com). Required if no template is set." }, "sitemapUrl": { "title": "Sitemap URL", "type": "string", "description": "Optional explicit sitemap.xml URL. Leave blank to auto-discover from the entry URL." }, "contentSelector": { "title": "Content CSS selector", "type": "string", "description": "CSS selector for the main content area on each page (e.g., \"article\", \"#content\", \"main article\"). Required for custom URLs." } } } }, "maxPagesPerSource": { "title": "Max pages per source", "minimum": 1, "maximum": 500, "type": "integer", "description": "Cap on how many pages each source can index at startup. Lower this to speed up boot for large docs sites; raise it for fuller coverage.", "default": 200 }, "cacheMaxPages": { "title": "Cache max pages", "minimum": 1, "maximum": 200, "type": "integer", "description": "How many fetched pages to hold in the LRU cache. Cached pages return instantly and become searchable by content; uncached pages match only on title.", "default": 50 }, "markdownOutput": { "title": "Markdown output", "type": "boolean", "description": "Convert extracted page HTML to clean markdown. Turn off to return raw text instead.", "default": true } } }, "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 } } } } } } } } } }