{"items":[{"type":"link","label":"Docs MCP","link":"/docs/realm/customization/mcp-server/openapi","routeSlug":"/docs/realm/customization/mcp-server/openapi","content":{"contentType":"overview","meta":{"name":"Docs MCP"},"children":[{"nodeType":"container","panels":[{"title":"Download OpenAPI description","titleTranslationKey":"download.description.title","children":[{"kind":"download","label":"openapi.json","url":"/_bundle/docs/realm/customization/mcp-server/openapi.json?download"},{"kind":"download","label":"openapi.yaml","url":"/_bundle/docs/realm/customization/mcp-server/openapi.yaml?download"}]},{"title":"Overview","titleTranslationKey":"info.title","children":[{"kind":"externallink","title":"URL","titleTranslationKey":"info.contact.url","label":"https://redocly.com","url":"https://redocly.com"},{"kind":"email","title":"E-mail","titleTranslationKey":"info.contact.name","email":"team@redocly.com","label":"team@redocly.com","withCopyButton":true,"copyContent":"team@redocly.com"},{"kind":"externallink","title":"License","titleTranslationKey":"info.license","label":"Custom","url":"https://redocly.com/subscription-agreement/"},{"kind":"externallink","label":"Terms of Service","labelTranslationKey":"info.termsOfService","url":"https://redocly.com/subscription-agreement/"}]},{"title":"Languages","titleTranslationKey":"languages.title","children":[{"kind":"languages","options":[{"key":"curl","title":"curl","lang":"curl"},{"key":"javascript","title":"JavaScript","lang":"JavaScript"},{"key":"node","title":"Node.js","lang":"Node.js"},{"key":"python","title":"Python","lang":"Python"},{"key":"java","title":"Java","lang":"Java"},{"key":"csharp","title":"C#","lang":"C#"},{"key":"php","title":"PHP","lang":"PHP"},{"key":"go","title":"Go","lang":"Go"},{"key":"ruby","title":"Ruby","lang":"Ruby"},{"key":"r","title":"R","lang":"R"},{"key":"payload","title":"Payload","lang":"Payload"}]}]},{"title":"MCP server","titleTranslationKey":"mcp.title","children":[{"kind":"attribute","label":"Protocol version","labelTranslationKey":"mcp.protocolVersion","value":"2025-06-18","withCopyButton":true,"copyContent":"2025-06-18"},{"kind":"tags","title":"Capabilities","titleTranslationKey":"mcp.capabilities","tags":[{"text":"logging","color":"green","icon":"checkmark"},{"text":"tools","color":"green","icon":"checkmark"}]},{"kind":"externallink","title":"Endpoint","titleTranslationKey":"mcp.endpoint","label":"https://{projectHost}/mcp","url":"https://{projectHost}/mcp","withCopyButton":true,"copyContent":"https://{projectHost}/mcp"},{"kind":"connect-mcp-button","title":"Connect","actions":["mcp-cursor","mcp-vscode"],"mcpUrl":"https://{projectHost}/mcp"}]},{"title":"Servers","titleTranslationKey":"servers.title","children":[{"kind":"servers","servers":[{"url":"/_mock/docs/realm/customization/mcp-server/openapi","description":"Mock server","isMockServer":true},{"url":"https://{projectHost}/mcp","description":"Project Docs MCP endpoint.","variables":{"projectHost":{"default":"redocly.com","description":"Project host. Prepend your path prefix if applicable."}}},{"url":"https://{projectHost}/mcp-public","description":"Public Docs MCP endpoint, served only when `mcp.docs.publicEndpoint` is enabled.\nIt requires no authentication and serves only content available to the `anonymous` team.\n","variables":{"projectHost":{"default":"redocly.com","description":"Project host. Prepend your path prefix if applicable."}}}],"mode":"default"}]}],"children":[{"nodeType":"overview-section-wrapper","children":[{"nodeType":"header","level":1,"label":"Docs MCP (1.0.0)","showPageActions":true},{"nodeType":"overview-section-wrapper","children":[{"nodeType":"markdoc","content":[{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect AI assistants to your project's Docs MCP server to browse API descriptions, inspect endpoints, and search documentation content."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Base URL:"]}," The Docs MCP server is available at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]}," on your project host. If your project is deployed under a path prefix, prepend that prefix to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Public endpoint:"]}," Projects that enable ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/config/mcp"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcp.docs.publicEndpoint"]}]}," also serve ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/mcp-public"]},". That endpoint requires no login and serves only the content that RBAC grants to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["anonymous"]}," team."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For setup and configuration guidance, see ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/customization/mcp-server"},"children":["Model Context Protocol server"]}," and ",{"$$mdtype":"Tag","name":"Link","attributes":{"href":"/docs/realm/config/mcp"},"children":["MCP configuration reference"]},"."]}]}]}]}],"sectionId":"/docs/realm/customization/mcp-server/openapi"}],"sectionId":"/docs/realm/customization/mcp-server/openapi"}]}]}},{"type":"group","label":"Identity","link":"/docs/realm/customization/mcp-server/openapi/authentication","routeSlug":"/docs/realm/customization/mcp-server/openapi/authentication","items":[{"type":"link","label":"whoami","link":"/docs/realm/customization/mcp-server/openapi/authentication/whoami","routeSlug":"/docs/realm/customization/mcp-server/openapi/authentication/whoami","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"whoami"},"meta":{"name":"whoami"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"whoami","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"McpTool","attributes":{"id":"/docs/realm/customization/mcp-server/openapi/authentication/whoami","name":"whoami"},"children":[]}]}}]}}],"content":{"contentType":"group","meta":{"name":"Authentication"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Identity","showPageActions":true},{"nodeType":"markdoc","content":"Tools for authentication and identity inspection for MCP clients when Docs MCP authentication handling is enabled."}],"panels":[{"children":[{"kind":"group-items","title":"MCP Tools","titleTranslationKey":"openapi.mcp.tools","items":[{"title":"whoami","prefix":{"name":"tool","color":"tool"},"link":"/authentication/whoami","deprecated":false}]}]}]}]}},{"type":"group","label":"API Catalog","link":"/docs/realm/customization/mcp-server/openapi/api-catalog","routeSlug":"/docs/realm/customization/mcp-server/openapi/api-catalog","items":[{"type":"link","label":"list-apis","link":"/docs/realm/customization/mcp-server/openapi/api-catalog/list-apis","routeSlug":"/docs/realm/customization/mcp-server/openapi/api-catalog/list-apis","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"list-apis"},"meta":{"name":"list-apis"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"list-apis","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"McpTool","attributes":{"id":"/docs/realm/customization/mcp-server/openapi/api-catalog/list-apis","name":"list-apis"},"children":[]}]}}]}},{"type":"link","label":"get-endpoints","link":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-endpoints","routeSlug":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-endpoints","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"get-endpoints"},"meta":{"name":"get-endpoints"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"get-endpoints","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"McpTool","attributes":{"id":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-endpoints","name":"get-endpoints"},"children":[]}]}}]}},{"type":"link","label":"get-endpoint-info","link":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-endpoint-info","routeSlug":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-endpoint-info","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"get-endpoint-info"},"meta":{"name":"get-endpoint-info"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"get-endpoint-info","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"McpTool","attributes":{"id":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-endpoint-info","name":"get-endpoint-info"},"children":[]}]}}]}},{"type":"link","label":"get-security-schemes","link":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-security-schemes","routeSlug":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-security-schemes","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"get-security-schemes"},"meta":{"name":"get-security-schemes"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"get-security-schemes","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"McpTool","attributes":{"id":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-security-schemes","name":"get-security-schemes"},"children":[]}]}}]}},{"type":"link","label":"get-full-api-description","link":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-full-api-description","routeSlug":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-full-api-description","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"get-full-api-description"},"meta":{"name":"get-full-api-description"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"get-full-api-description","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"McpTool","attributes":{"id":"/docs/realm/customization/mcp-server/openapi/api-catalog/get-full-api-description","name":"get-full-api-description"},"children":[]}]}}]}}],"content":{"contentType":"group","meta":{"name":"API Catalog"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"API Catalog","showPageActions":true},{"nodeType":"markdoc","content":"Tools for discovering published APIs, inspecting endpoints, reviewing security schemes, and retrieving full OpenAPI descriptions."}],"panels":[{"children":[{"kind":"group-items","title":"MCP Tools","titleTranslationKey":"openapi.mcp.tools","items":[{"title":"list-apis","prefix":{"name":"tool","color":"tool"},"link":"/api-catalog/list-apis","deprecated":false},{"title":"get-endpoints","prefix":{"name":"tool","color":"tool"},"link":"/api-catalog/get-endpoints","deprecated":false},{"title":"get-endpoint-info","prefix":{"name":"tool","color":"tool"},"link":"/api-catalog/get-endpoint-info","deprecated":false},{"title":"get-security-schemes","prefix":{"name":"tool","color":"tool"},"link":"/api-catalog/get-security-schemes","deprecated":false},{"title":"get-full-api-description","prefix":{"name":"tool","color":"tool"},"link":"/api-catalog/get-full-api-description","deprecated":false}]}]}]}]}},{"type":"group","label":"Search","link":"/docs/realm/customization/mcp-server/openapi/search","routeSlug":"/docs/realm/customization/mcp-server/openapi/search","items":[{"type":"link","label":"search","link":"/docs/realm/customization/mcp-server/openapi/search/search","routeSlug":"/docs/realm/customization/mcp-server/openapi/search/search","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"search"},"meta":{"name":"search"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"search","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"McpTool","attributes":{"id":"/docs/realm/customization/mcp-server/openapi/search/search","name":"search"},"children":[]}]}}]}}],"content":{"contentType":"group","meta":{"name":"Search"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Search","showPageActions":true},{"nodeType":"markdoc","content":"Tools for searching documentation content."}],"panels":[{"children":[{"kind":"group-items","title":"MCP Tools","titleTranslationKey":"openapi.mcp.tools","items":[{"title":"search","prefix":{"name":"tool","color":"tool"},"link":"/search/search","deprecated":false}]}]}]}]}},{"type":"group","label":"Feedback","link":"/docs/realm/customization/mcp-server/openapi/feedback","routeSlug":"/docs/realm/customization/mcp-server/openapi/feedback","items":[{"type":"link","label":"submit-feedback","link":"/docs/realm/customization/mcp-server/openapi/feedback/submit-feedback","routeSlug":"/docs/realm/customization/mcp-server/openapi/feedback/submit-feedback","httpVerb":"tool","content":{"contentType":"item","seo":{"title":"submit-feedback"},"meta":{"name":"submit-feedback"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"submit-feedback","showPageActions":true}],"panels":[]},{"nodeType":"markdoc","content":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"McpTool","attributes":{"id":"/docs/realm/customization/mcp-server/openapi/feedback/submit-feedback","name":"submit-feedback"},"children":[]}]}}]}}],"content":{"contentType":"group","meta":{"name":"Feedback"},"children":[{"nodeType":"container","children":[{"nodeType":"header","level":2,"label":"Feedback","showPageActions":true},{"nodeType":"markdoc","content":"Tools that report documentation problems to the project team."}],"panels":[{"children":[{"kind":"group-items","title":"MCP Tools","titleTranslationKey":"openapi.mcp.tools","items":[{"title":"submit-feedback","prefix":{"name":"tool","color":"tool"},"link":"/feedback/submit-feedback","deprecated":false}]}]}]}]}}],"store":{"schemaStore":{"components/schemas/OpenApiServer":{"id":"components/schemas/OpenApiServer","kind":"json-schema","title":"OpenApiServer","data":{"type":"object","description":"OpenAPI Server Object for the published API description.","properties":{"url":{"type":"string","description":"Server URL."},"description":{"type":"string","description":"Human-readable server description."},"name":{"type":"string","description":"Optional server name."},"variables":{"type":"object","description":"Server variable definitions keyed by variable name.","additionalProperties":{"type":"object","properties":{"default":{"type":"string"},"enum":{"type":"array","items":{"type":"string"}},"description":{"type":"string"}}}}},"required":["url"],"additionalProperties":true}},"components/schemas/ApiCatalogItem":{"id":"components/schemas/ApiCatalogItem","kind":"json-schema","title":"ApiCatalogItem","data":{"type":"object","description":"API entry returned by the docs catalog.","properties":{"name":{"type":"string","description":"API name used by the Docs MCP tools."},"description":{"type":"string","description":"API description or summary."},"version":{"type":"string","description":"API version string from the source description."},"servers":{"type":"array","description":"Servers defined by the published OpenAPI description.","items":{"$ref":"#/components/schemas/OpenApiServer"}},"filePath":{"type":"string","description":"Path to the API description file."}},"required":["name","filePath"],"additionalProperties":false}},"components/schemas/ApiEndpointSummary":{"id":"components/schemas/ApiEndpointSummary","kind":"json-schema","title":"ApiEndpointSummary","data":{"type":"object","description":"Endpoint summary returned by the API catalog tools.","properties":{"path":{"type":"string","description":"Endpoint path."},"method":{"type":"string","description":"Uppercase HTTP method."},"summary":{"type":"string","description":"OpenAPI operation summary."},"description":{"type":"string","description":"OpenAPI operation description."},"security":{"type":"array","description":"Operation security requirements from the source OpenAPI description.","items":{"type":"object","additionalProperties":true}}},"required":["path","method"],"additionalProperties":false}},"components/schemas/WhoAmIOutput":{"id":"components/schemas/WhoAmIOutput","kind":"json-schema","title":"WhoAmIOutput","data":{"type":"object","description":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Authenticated user details returned by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whoami"]}," tool."]}]},"properties":{"email":{"type":"string"},"name":{"type":"string"},"subject":{"type":"string"},"clientId":{"type":"string"},"scope":{"type":"string"},"issuedAt":{"type":"string","format":"date-time"},"expiresAt":{"type":"string","format":"date-time"}},"additionalProperties":false}},"components/schemas/ListApisOutput":{"id":"components/schemas/ListApisOutput","kind":"json-schema","title":"ListApisOutput","data":{"type":"object","description":"Paginated list of APIs available through the Docs MCP server.","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/ApiCatalogItem"}},"limit":{"type":"number"},"total":{"type":"number"},"page":{"type":"number"},"totalPages":{"type":"number"}},"required":["items","limit","total","page","totalPages"],"additionalProperties":false}},"components/schemas/ApiDescriptionRef":{"id":"components/schemas/ApiDescriptionRef","kind":"json-schema","title":"ApiDescriptionRef","data":{"type":"object","description":"Reference to an API description file the lookup also matched.","properties":{"version":{"type":"string","description":"API version."},"filePath":{"type":"string","description":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API description file path. Pass it as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["filePath"]}," to load this definition."]}]}}},"required":["filePath"],"additionalProperties":false}},"components/schemas/GetEndpointsOutput":{"id":"components/schemas/GetEndpointsOutput","kind":"json-schema","title":"GetEndpointsOutput","data":{"type":"object","description":"Endpoint list for a single published API.","properties":{"api":{"type":"string","description":"API title."},"version":{"type":"string","description":"API version."},"filePath":{"type":"string","description":"API description file path for this result."},"otherMatches":{"type":"array","description":"Other description files the lookup matched. Present only when several share the requested name.","items":{"$ref":"#/components/schemas/ApiDescriptionRef"}},"servers":{"type":"array","description":"Servers defined by the published OpenAPI description.","items":{"$ref":"#/components/schemas/OpenApiServer"}},"endpoints":{"type":"array","items":{"$ref":"#/components/schemas/ApiEndpointSummary"}}},"required":["api","version","filePath","servers","endpoints"],"additionalProperties":false}},"components/schemas/GetEndpointInfoOutput":{"id":"components/schemas/GetEndpointInfoOutput","kind":"json-schema","title":"GetEndpointInfoOutput","data":{"type":"object","description":"Detailed endpoint information with resolved OpenAPI structures.","properties":{"api":{"type":"string","description":"API title."},"version":{"type":"string","description":"API version."},"filePath":{"type":"string","description":"API description file path for this result."},"otherMatches":{"type":"array","description":"Other description files the lookup matched. Present only when several share the requested name.","items":{"$ref":"#/components/schemas/ApiDescriptionRef"}},"servers":{"type":"array","description":"Servers defined by the published OpenAPI description.","items":{"$ref":"#/components/schemas/OpenApiServer"}},"endpoint":{"type":"object","description":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Endpoint details derived from the resolved OpenAPI operation. Besides ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["path"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["method"]},", the object may include parameters, request body, responses, security, examples, and other operation-level fields from the source OpenAPI description."]}]},"properties":{"path":{"type":"string"},"method":{"type":"string"}},"required":["path","method"],"additionalProperties":true},"globalSecurity":{"type":"array","description":"Global security requirements defined on the OpenAPI document.","items":{"type":"object","additionalProperties":true}},"securitySchemes":{"type":"object","description":"Security schemes map from the OpenAPI components section.","additionalProperties":true},"components":{"type":"object","description":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Components that the endpoint references, keyed as the source OpenAPI description keys them. A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["$ref"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["endpoint"]}," resolves against the root of the result."]}]},"additionalProperties":true}},"required":["api","version","filePath","servers","endpoint","globalSecurity","securitySchemes"],"additionalProperties":false}},"components/schemas/GetSecuritySchemesOutput":{"id":"components/schemas/GetSecuritySchemesOutput","kind":"json-schema","title":"GetSecuritySchemesOutput","data":{"type":"object","description":"Security metadata returned for a published API.","properties":{"name":{"type":"string","description":"API title."},"version":{"type":"string","description":"API version."},"filePath":{"type":"string","description":"API description file path for this result."},"otherMatches":{"type":"array","description":"Other description files the lookup matched. Present only when several share the requested name.","items":{"$ref":"#/components/schemas/ApiDescriptionRef"}},"securitySchemes":{"type":"object","description":"Security schemes map from the OpenAPI components section.","additionalProperties":true},"security":{"type":"array","description":"Global security requirements defined on the OpenAPI document.","items":{"type":"object","additionalProperties":true}}},"required":["name","version","filePath","securitySchemes","security"],"additionalProperties":false}},"components/schemas/GetFullApiDescriptionOutput":{"id":"components/schemas/GetFullApiDescriptionOutput","kind":"json-schema","title":"GetFullApiDescriptionOutput","data":{"type":"object","description":"Full published OpenAPI document after access filtering.","properties":{"api":{"type":"string","description":"API title."},"version":{"type":"string","description":"API version."},"filePath":{"type":"string","description":"API description file path for this result."},"otherMatches":{"type":"array","description":"Other description files the lookup matched. Present only when several share the requested name.","items":{"$ref":"#/components/schemas/ApiDescriptionRef"}},"definition":{"type":"object","description":"Full OpenAPI description file returned by the Docs MCP server.","additionalProperties":true}},"required":["api","version","filePath","definition"],"additionalProperties":false}},"components/schemas/SearchOutput":{"id":"components/schemas/SearchOutput","kind":"json-schema","title":"SearchOutput","data":{"type":"string","description":"Markdown string containing the rendered search results."}},"components/schemas/SubmitFeedbackOutput":{"id":"components/schemas/SubmitFeedbackOutput","kind":"json-schema","title":"SubmitFeedbackOutput","data":{"type":"object","description":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirmation returned by the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["submit-feedback"]}," tool."]}]},"properties":{"status":{"type":"string","enum":["received"]},"page":{"type":"string","description":"Absolute URL of the page the feedback refers to."},"message":{"type":"string"}},"required":["status","page","message"],"additionalProperties":false}}},"exampleStore":{},"securitySchemeStore":{"OAuth2":{"id":"OAuth2","type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://{projectHost}/_mcp/oauth2/auth","tokenUrl":"https://{projectHost}/_mcp/oauth2/token-portal","scopes":{}}}}},"mcp":{"protocolVersion":"2025-06-18","servers":[{"url":"https://{projectHost}/mcp","description":"Project Docs MCP endpoint.","variables":{"projectHost":{"default":"redocly.com","description":"Project host. Prepend your path prefix if applicable."}}},{"url":"https://{projectHost}/mcp-public","description":"Public Docs MCP endpoint, served only when `mcp.docs.publicEndpoint` is enabled.\nIt requires no authentication and serves only content available to the `anonymous` team.\n","variables":{"projectHost":{"default":"redocly.com","description":"Project host. Prepend your path prefix if applicable."}}}],"capabilities":{"logging":{},"tools":{"listChanged":true}},"tools":[{"name":"whoami","description":"Get information about the currently authenticated user","inputSchema":{"type":"object","additionalProperties":false,"properties":{}},"outputSchema":{"$ref":"#/components/schemas/WhoAmIOutput"},"tags":["Authentication"]},{"name":"list-apis","description":"Lists available APIs with their context and purpose","inputSchema":{"type":"object","additionalProperties":false,"properties":{"filter":{"type":"string","description":"Matches part of an API name, or of a description when no name matches","minLength":1},"page":{"type":"number","description":"Page number","minimum":1,"default":1},"limit":{"type":"number","description":"Number of APIs per page. Default is 300","minimum":1,"default":300}}},"outputSchema":{"$ref":"#/components/schemas/ListApisOutput"},"tags":["API Catalog"]},{"name":"get-endpoints","description":"Get all endpoints for a specific API.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","description":"API name, or a unique part of it. Omit when `filePath` is given.","minLength":1},"version":{"type":"string","description":"API version. When omitted and several versions exist, the highest one is used."},"filePath":{"type":"string","description":"Path to the API description file."}}},"outputSchema":{"$ref":"#/components/schemas/GetEndpointsOutput"},"tags":["API Catalog"]},{"name":"get-endpoint-info","description":"Get comprehensive information about specific endpoint including parameters, security, and examples","inputSchema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","description":"API name, or a unique part of it. Omit when `filePath` is given.","minLength":1},"path":{"type":"string","description":"Endpoint path (for example, `/users`)","minLength":1},"method":{"type":"string","description":"HTTP method","enum":["GET","POST","PUT","DELETE","PATCH","OPTIONS","HEAD","TRACE","get","post","put","delete","patch","options","head","trace"],"minLength":1},"version":{"type":"string","description":"API version. When omitted and several versions exist, the highest one is used."},"filePath":{"type":"string","description":"Path to the API description file."}},"required":["path","method"]},"outputSchema":{"$ref":"#/components/schemas/GetEndpointInfoOutput"},"tags":["API Catalog"]},{"name":"get-security-schemes","description":"Get the security schemes for a specific API","inputSchema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","description":"API name, or a unique part of it. Omit when `filePath` is given.","minLength":1},"version":{"type":"string","description":"API version. When omitted and several versions exist, the highest one is used."},"filePath":{"type":"string","description":"Path to the API description file."}}},"outputSchema":{"$ref":"#/components/schemas/GetSecuritySchemesOutput"},"tags":["API Catalog"]},{"name":"get-full-api-description","description":"Get the complete OpenAPI description.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"name":{"type":"string","description":"API name, or a unique part of it. Omit when `filePath` is given.","minLength":1},"version":{"type":"string","description":"API version. When omitted and several versions exist, the highest one is used."},"filePath":{"type":"string","description":"Path to the API description file."}}},"outputSchema":{"$ref":"#/components/schemas/GetFullApiDescriptionOutput"},"tags":["API Catalog"]},{"name":"search","description":"Search across the documentation to fetch relevant content for a given query.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","description":"Search query.","minLength":1},"product":{"type":"string","description":"Optional product name to filter search results by specific product."}},"required":["query"]},"outputSchema":{"$ref":"#/components/schemas/SearchOutput"},"tags":["Search"]},{"name":"submit-feedback","description":"Report a documentation page that is wrong or incomplete.","inputSchema":{"type":"object","additionalProperties":false,"properties":{"path":{"type":"string","description":"Path or URL of the documentation page the feedback is about (e.g. /guides/auth).","minLength":1,"maxLength":1000},"summary":{"type":"string","description":"One sentence that names what is wrong with the page.","minLength":1,"maxLength":500},"details":{"type":"string","description":"Expected versus actual behavior, missing steps, or the snippet that failed.","maxLength":4000},"targetFeature":{"type":"string","description":"The API or feature the page documents.","maxLength":500}},"required":["path","summary"]},"outputSchema":{"$ref":"#/components/schemas/SubmitFeedbackOutput"},"tags":["Feedback"]}]},"servers":[{"url":"/_mock/docs/realm/customization/mcp-server/openapi","isMockServer":true,"description":"Mock server"},{"url":"https://{projectHost}/mcp","description":"Project Docs MCP endpoint.","variables":{"projectHost":{"default":"redocly.com","description":"Project host. Prepend your path prefix if applicable."}}},{"url":"https://{projectHost}/mcp-public","description":"Public Docs MCP endpoint, served only when `mcp.docs.publicEndpoint` is enabled.\nIt requires no authentication and serves only content available to the `anonymous` team.\n","variables":{"projectHost":{"default":"redocly.com","description":"Project host. Prepend your path prefix if applicable."}}}],"specType":"openapi"},"options":{"excludeFromSearch":true,"downloadUrls":[{"url":"/_bundle/docs/realm/customization/mcp-server/openapi.json?download"},{"url":"/_bundle/docs/realm/customization/mcp-server/openapi.yaml?download"}],"mockServer":{"url":"/_mock/docs/realm/customization/mcp-server/openapi","position":"first","description":"Mock server"}},"specType":"openapi","title":"Docs MCP","metadata":{}}