{"openapi":"3.1.1","info":{"title":"Daoco public HTTP and MCP endpoints","version":"1.1.21","description":"Public website discovery and the canonical MCP transport. Marketing work uses MCP tools, not REST resources. Dashboard APIs require browser sessions and are not a public integration API.","contact":{"email":"support@daoco.org","url":"https://daoco.org/contact"}},"servers":[{"url":"https://daoco.org"}],"externalDocs":{"url":"https://docs.daoco.org/connections/ai-apps","description":"MCP setup, tools, asynchronous work, and approval boundaries"},"paths":{"/api":{"get":{"operationId":"getApiDiscovery","summary":"Discover HTTP and MCP entry points","responses":{"200":{"description":"Public discovery links","content":{"application/json":{"schema":{"type":"object","required":["name","openapi","mcp","documentation","description"],"properties":{"name":{"type":"string"},"openapi":{"type":"string"},"mcp":{"type":"string"},"documentation":{"type":"string"},"description":{"type":"string"}}}}}}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"Check web server availability","responses":{"200":{"description":"Web server is responding; downstream services are not checked","content":{"application/json":{"schema":{"type":"object","required":["status","timestamp"],"properties":{"status":{"const":"ok"},"timestamp":{"type":"string","format":"date-time"}}}}}}}}},"/":{"get":{"operationId":"getHomepage","summary":"Read the homepage as HTML or Markdown","description":"Send Accept: text/markdown for Markdown. Explicit HTML preferences are respected. Markdown responses include Vary: Accept and Cache-Control: no-store.","responses":{"200":{"description":"Homepage representation","content":{"text/html":{"schema":{"type":"string"}},"text/markdown":{"schema":{"type":"string"}}}}}}},"/llms.txt":{"get":{"operationId":"getSiteIndex","summary":"Read the public site index","responses":{"200":{"description":"Site index in Markdown","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/llms-full.txt":{"get":{"operationId":"getProductProfile","summary":"Read the public product profile","responses":{"200":{"description":"Product profile in Markdown","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/mcp":{"servers":[{"url":"https://backend.daoco.org"}],"post":{"operationId":"mcpRequest","summary":"Send an MCP JSON-RPC message","description":"Canonical OAuth resource: https://backend.daoco.org/mcp. Follow protected-resource discovery and its authorization server metadata. Supports legacy initialize negotiation and stateless server/discover. Modern requests mirror protocol version, method, and tool name in headers and params._meta. tools/list supplies tool input schemas. Tool errors can appear in a result with isError=true. Batch messages and standalone SSE streams are not supported.","security":[{"mcpOAuth":[]}],"parameters":[{"name":"MCP-Protocol-Version","in":"header","schema":{"type":"string"},"description":"Negotiated MCP version; must match params._meta for modern requests."},{"name":"Mcp-Method","in":"header","schema":{"type":"string"},"description":"Matches the JSON-RPC method for modern requests."},{"name":"Mcp-Name","in":"header","schema":{"type":"string"},"description":"Matches params.name for modern tools/call requests."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"}}}},"responses":{"200":{"description":"JSON-RPC result or error; inspect result.isError for tool errors","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"202":{"description":"Notification accepted; no response body"},"400":{"description":"Malformed message or protocol header mismatch","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"401":{"description":"Missing or invalid OAuth access token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}},"headers":{"WWW-Authenticate":{"description":"Bearer challenge with the protected-resource metadata URL","schema":{"type":"string"}}}},"403":{"description":"Origin not allowed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"413":{"description":"Request too large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}},"503":{"description":"MCP not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}}}}}}},"/.well-known/oauth-protected-resource/mcp":{"servers":[{"url":"https://backend.daoco.org"}],"get":{"operationId":"getMcpProtectedResource","summary":"Discover the MCP OAuth resource and issuer","responses":{"200":{"description":"OAuth protected-resource metadata","content":{"application/json":{"schema":{"type":"object","required":["resource","authorization_servers"],"properties":{"resource":{"type":"string","format":"uri"},"authorization_servers":{"type":"array","items":{"type":"string","format":"uri"}}}}}}}}}}},"components":{"securitySchemes":{"mcpOAuth":{"type":"openIdConnect","openIdConnectUrl":"https://auth.daoco.org/.well-known/openid-configuration","description":"WorkOS OAuth access token for resource https://backend.daoco.org/mcp. MCP clients follow protected-resource discovery and the advertised authorization server metadata."}},"schemas":{"Problem":{"type":"object","required":["type","title","status","detail","code","resolution"],"properties":{"type":{"type":"string","format":"uri-reference"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"},"code":{"type":"string"},"resolution":{"type":"string"}},"description":"RFC 9457 application/problem+json for dashboard authentication failures and unmatched API routes. Existing API routes and MCP retain their own error contracts."},"JsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"type":"string"},"params":{"type":"object","additionalProperties":true}}},"JsonRpcResponse":{"oneOf":[{"type":"object","required":["jsonrpc","id","result"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number","null"]},"result":{}},"not":{"required":["error"]}},{"type":"object","required":["jsonrpc","error"],"description":"Errors raised before request dispatch, including authentication failures, omit id.","properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number","null"]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{}}}},"not":{"required":["result"]}}]}}}}