openapi: 3.1.0
info:
  title: damore.ai Intake, MCP, And Public Discovery
  version: 1.1.0
  description: Public metadata for damore.ai private AI safety audit discovery, MCP intake guidance, and intake handoff. Agents can read llms-full.txt, use the published Agent Skill, or initialize the MCP endpoint for structured intake guidance.
  contact:
    name: Beau D'Amore
    email: beau@damore.ai
    url: https://www.damore.ai/intake
  license:
    name: Proprietary public website content
servers:
  - url: https://www.damore.ai
paths:
  /intake:
    get:
      operationId: viewIntakePage
      summary: View the private AI safety audit intake page.
      description: Returns the public intake page where a user can request a private AI safety audit, OpenWebUI hardening scope, private AI workspace, document workflow, or public knowledge guide discussion.
      responses:
        "200":
          description: Intake page HTML.
          content:
            text/html:
              schema:
                type: string
  /llms.txt:
    get:
      operationId: getShortAgentContext
      summary: Get concise agent context for damore.ai.
      responses:
        "200":
          description: Concise text context for AI agents.
          content:
            text/plain:
              schema:
                type: string
  /llms-full.txt:
    get:
      operationId: getFullAgentContext
      summary: Get full agent context for damore.ai.
      responses:
        "200":
          description: Full structured text context for AI agents.
          content:
            text/plain:
              schema:
                type: string
  /mcp:
    post:
      operationId: mcpJsonRpc
      summary: Send a Model Context Protocol JSON-RPC message.
      description: Stateless MCP Streamable HTTP endpoint exposing the damore_ai_intake tool for private AI safety, OpenWebUI hardening, document workflow, and public knowledge guide intake guidance.
      parameters:
        - name: MCP-Protocol-Version
          in: header
          required: false
          schema:
            type: string
            enum:
              - "2025-06-18"
              - "2025-03-26"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/McpJsonRpcRequest"
            examples:
              initialize:
                summary: Initialize MCP session
                value:
                  jsonrpc: "2.0"
                  id: 1
                  method: initialize
                  params:
                    protocolVersion: "2025-06-18"
                    capabilities: {}
                    clientInfo:
                      name: example-agent
                      version: "1.0.0"
              listTools:
                summary: List tools
                value:
                  jsonrpc: "2.0"
                  id: 2
                  method: tools/list
              callTool:
                summary: Call intake tool
                value:
                  jsonrpc: "2.0"
                  id: 3
                  method: tools/call
                  params:
                    name: damore_ai_intake
                    arguments:
                      message: Can damore.ai help harden an OpenWebUI deployment?
      responses:
        "200":
          description: JSON-RPC response.
          headers:
            MCP-Protocol-Version:
              schema:
                type: string
                example: "2025-06-18"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/McpJsonRpcResponse"
        "202":
          description: JSON-RPC notification accepted.
        "400":
          description: Invalid JSON-RPC request or unsupported protocol version.
        "405":
          description: Use POST for JSON-RPC requests.
components:
  schemas:
    IntakeSummary:
      type: object
      additionalProperties: false
      properties:
        name:
          type: string
        email:
          type: string
          format: email
        company:
          type: string
        situation:
          type: string
          enum:
            - AI safety readiness audit
            - Public AI use with sensitive data
            - OpenWebUI or local AI hardening
            - Private AI workspace
            - Document-heavy workflow
            - Public knowledge guide
            - Not sure yet
        use_case:
          type: string
        desired_timeline:
          type: string
        budget:
          type: string
      required:
        - email
        - situation
    McpJsonRpcRequest:
      type: object
      additionalProperties: true
      properties:
        jsonrpc:
          type: string
          const: "2.0"
        id:
          oneOf:
            - type: string
            - type: integer
        method:
          type: string
          enum:
            - initialize
            - notifications/initialized
            - ping
            - tools/list
            - tools/call
        params:
          type: object
      required:
        - jsonrpc
        - method
    McpJsonRpcResponse:
      type: object
      additionalProperties: false
      properties:
        jsonrpc:
          type: string
          const: "2.0"
        id:
          oneOf:
            - type: string
            - type: integer
            - type: "null"
        result:
          type: object
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            data:
              type: object
      required:
        - jsonrpc
        - id
