{"openapi":"3.1.0","info":{"title":"Architecture Studio MCP transport","version":"1.0.0","description":"HTTP transport description, not a REST replacement for MCP. Initialize an MCP session and discover tool schemas through tools/list. This version identifies this document, not the deployed Arch Studio release."},"servers":[{"url":"https://mcp.architecturestudio.ai/"}],"externalDocs":{"description":"Architecture Studio developer documentation","url":"https://architecturestudio.ai/docs"},"paths":{"/":{"post":{"operationId":"sendMcpMessage","summary":"Send a JSON-RPC MCP message over Streamable HTTP","description":"Follow the MCP lifecycle and negotiated protocol version. Preserve any session identifier returned by the server. Notifications may receive 202. Authentication is required, including for tools/list.","security":[{"asOAuth":["openid","profile","email"]}],"parameters":[{"in":"header","name":"Accept","required":true,"schema":{"type":"string","examples":["application/json, text/event-stream"]},"description":"MCP POST clients must accept both JSON and SSE."},{"in":"header","name":"MCP-Protocol-Version","schema":{"type":"string"},"description":"Negotiated version on requests after initialization."},{"in":"header","name":"MCP-Session-Id","schema":{"type":"string"},"description":"Include only when issued by the server."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"method":{"type":"string"},"params":{"type":"object","additionalProperties":true}},"additionalProperties":false},{"type":"object","required":["jsonrpc","id","result"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number"]},"result":{"type":"object","additionalProperties":true}},"additionalProperties":false},{"type":"object","required":["jsonrpc","id","error"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"type":["string","number","null"]},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"integer"},"message":{"type":"string"},"data":{}},"additionalProperties":false}},"additionalProperties":false}]}}}},"responses":{"200":{"description":"MCP response, potentially streamed.","content":{"application/json":{"schema":{"type":"object"}},"text/event-stream":{"schema":{"type":"string"}}}},"202":{"description":"Notification accepted."},"400":{"description":"Invalid MCP request."},"401":{"description":"OAuth required; follow resource_metadata in WWW-Authenticate.","headers":{"WWW-Authenticate":{"schema":{"type":"string"}}}},"403":{"description":"Token or permissions rejected."}}}}},"components":{"securitySchemes":{"asOAuth":{"type":"oauth2","description":"Current identity scopes, not per-tool project permissions. Authoritative resource metadata: https://mcp.architecturestudio.ai/.well-known/oauth-protected-resource. Authorization discovery: https://clerk.architecturestudio.ai/.well-known/oauth-authorization-server. Use PKCE S256.","flows":{"authorizationCode":{"authorizationUrl":"https://clerk.architecturestudio.ai/oauth/authorize","tokenUrl":"https://clerk.architecturestudio.ai/oauth/token","scopes":{"openid":"Identify the signed-in user.","profile":"Read the user’s basic profile.","email":"Read the user’s email identity."}}}}}}}