{"openapi":"3.0.1","info":{"title":"MCP Server Well-Known Discovery","description":"<p>Discovery endpoints exposed under /.well-known for MCP clients, including OAuth 2.0 Protected Resource Metadata and MCP discovery.</p>","version":"1.0"},"servers":[{"url":"https://int4-apim.test.apimanagement.eu10.hana.ondemand.com:443/.well-known"}],"paths":{"/oauth-protected-resource":{"get":{"tags":["OAuthDiscovery"],"summary":"OAuth 2.0 Protected Resource Metadata","description":"OAuth 2.0 Protected Resource Metadata endpoint (RFC 9728). Used by MCP clients to discover authorization servers protecting this resource.","responses":{"200":{"description":"OAuth protected resource metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthProtectedResource"},"examples":{"public":{"summary":"Public MCP resource (no OAuth)","value":{"resource":"https://int4-apim.test.apimanagement.eu10.hana.ondemand.com","authorization_servers":[]}},"oauth":{"summary":"OAuth protected MCP resource","value":{"resource":"https://int4-apim.test.apimanagement.eu10.hana.ondemand.com","authorization_servers":["https://<tenant>.accounts.ondemand.com"]}}}}}},"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"options":{"tags":["OAuthDiscovery"],"description":"","responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/mcp.json":{"get":{"tags":["MCPDiscovery"],"summary":"MCP server discovery","description":"MCP discovery document exposed under /.well-known/mcp.json. Points to MCP API exposed under /mcp base path.","responses":{"200":{"description":"MCP discovery document","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MCPDiscovery"},"examples":{"minimal":{"summary":"Minimal MCP discovery","value":{"version":"1.0","name":"ABAP MCP Server","tools":{"list":{"href":"/mcp/tools","method":"GET"}}}}}}}},"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/oauth-authorization-server":{"get":{"tags":["AuthorizationServer"],"description":"","responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"options":{"tags":["AuthorizationServer"],"description":"","responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/openid-configuration":{"get":{"tags":["OpenIdConfiguration"],"description":"","responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"options":{"tags":["OpenIdConfiguration"],"description":"","responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/token":{"options":{"tags":["Token"],"description":"","responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["Token"],"description":"","requestBody":{"description":"Payload to add to resource collection","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Payload"}}},"required":true},"responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"get":{"tags":["Token"],"description":"","responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/authorize":{"get":{"tags":["Authorize"],"description":"","responses":{"default":{"description":"error payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"specVersion":"V30","components":{"schemas":{"OAuthProtectedResource":{"type":"object","required":["resource","authorization_servers"],"properties":{"resource":{"type":"string","format":"uri","description":"Identifier of the protected resource"},"authorization_servers":{"type":"array","description":"OAuth 2.0 Authorization Servers protecting this resource","items":{"type":"string","format":"uri"}}}},"MCPDiscovery":{"type":"object","required":["version","name"],"properties":{"version":{"type":"string","description":"MCP protocol version"},"name":{"type":"string","description":"Human readable MCP server name"},"description":{"type":"string"},"tools":{"type":"object","description":"MCP tools discovery section","properties":{"list":{"$ref":"#/components/schemas/MCPToolList"}}},"resources":{"type":"object","description":"MCP resources discovery section","properties":{"list":{"$ref":"#/components/schemas/MCPResourceList"}}}}},"MCPToolList":{"type":"object","required":["href","method"],"properties":{"href":{"type":"string","description":"Relative URL to MCP tools endpoint","example":"/mcp/tools"},"method":{"type":"string","example":"GET"}}},"MCPResourceList":{"type":"object","required":["href","method"],"properties":{"href":{"type":"string","description":"Relative URL to MCP resources endpoint","example":"/mcp/resources"},"method":{"type":"string","example":"GET"}}},"Error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"integer","format":"int32"},"fields":{"type":"string"}}},"Payload":{"type":"object","properties":{"Payload":{"type":"string"}}}}},"tags":[{"name":"OAuthDiscovery","description":"OAuth 2.0 Protected Resource Metadata"},{"name":"MCPDiscovery","description":"MCP server discovery (.well-known/mcp.json)"}],"definitions":{}}