# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Live Direct Marketing Online MCP Transport API
  version: 1.0.0
extends: openapi/live-direct-marketing-online-mcp-transport-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 14
- target: $.paths['/api/mcp'].get
  update:
    x-apievangelist-phrasing:
      intent: Open the MCP stream at the root endpoint
      effect: read
      questions:
      - Can my MCP client open a server-sent event stream with a GET on the root /api/mcp endpoint?
      - What does a GET to the base MCP endpoint do in the streamable-http transport?
      instructions:
      - text: Send a GET to the root MCP endpoint to open the event stream.
      - text: Open a streamable-http listening stream on /api/mcp itself.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp'].put
  update:
    x-apievangelist-phrasing:
      intent: Send a PUT to the root MCP endpoint
      effect: write
      questions:
      - Does the root /api/mcp endpoint accept PUT requests?
      - What happens if my MCP client issues a PUT against the base MCP path?
      instructions:
      - text: Send a PUT request to the root MCP endpoint.
      - text: Issue PUT on /api/mcp without a sub-path.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp'].post
  update:
    x-apievangelist-phrasing:
      intent: Post a JSON-RPC message to the MCP root
      effect: write
      questions:
      - How do I send MCP JSON-RPC messages like initialize or tools/call to the root endpoint?
      - Can I connect an MCP client by POSTing to /api/mcp directly?
      instructions:
      - text: POST my MCP JSON-RPC message to the root /api/mcp endpoint.
      - text: Initialize an MCP session by posting to the base MCP endpoint.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp'].delete
  update:
    x-apievangelist-phrasing:
      intent: End an MCP session at the root endpoint
      effect: destructive
      questions:
      - How do I terminate my MCP session on the root endpoint when I'm done?
      - Can a DELETE to /api/mcp close the streamable-http session?
      instructions:
      - text: Close my MCP session with a DELETE to the root /api/mcp endpoint.
      - text: Terminate the streamable-http session on the base MCP path.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp'].patch
  update:
    x-apievangelist-phrasing:
      intent: Send a PATCH to the root MCP endpoint
      effect: write
      questions:
      - Is PATCH routed to the same handler on the root /api/mcp endpoint?
      - What does the base MCP endpoint do with a PATCH request?
      instructions:
      - text: Send a PATCH request to the root MCP endpoint.
      - text: Issue PATCH on /api/mcp with no sub-path.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp'].head
  update:
    x-apievangelist-phrasing:
      intent: Check the root MCP endpoint with HEAD
      effect: read
      questions:
      - Can I probe whether the root MCP endpoint is reachable without a body?
      - Does a HEAD request against /api/mcp respond?
      instructions:
      - text: Send a HEAD request to the root MCP endpoint to check it is up.
      - text: Probe /api/mcp itself with HEAD.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp'].options
  update:
    x-apievangelist-phrasing:
      intent: Run a CORS preflight on the MCP root
      effect: read
      questions:
      - Will a browser-based MCP client pass the CORS preflight on /api/mcp?
      - Which methods does the root MCP endpoint allow in an OPTIONS response?
      instructions:
      - text: Send an OPTIONS preflight to the root MCP endpoint.
      - text: Check the allowed methods on /api/mcp with OPTIONS.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp/{path}'].get
  update:
    x-apievangelist-phrasing:
      intent: Open the MCP stream on a sub-path
      effect: read
      questions:
      - Can my MCP client open its event stream with a GET on a path under /api/mcp/?
      - What does a GET to an /api/mcp/ sub-path return?
      instructions:
      - text: Send a GET to MCP sub-path {path} under /api/mcp/ to open the stream.
        slots:
          path: path.path
      - text: Open the streamable-http listener on a nested MCP path.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp/{path}'].put
  update:
    x-apievangelist-phrasing:
      intent: Send a PUT to an MCP sub-path
      effect: write
      questions:
      - Do nested paths under /api/mcp/ accept PUT requests?
      - What happens when a PUT hits an MCP sub-path?
      instructions:
      - text: Send a PUT request to MCP sub-path {path} under /api/mcp/.
        slots:
          path: path.path
      - text: Issue PUT on a nested MCP route.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp/{path}'].post
  update:
    x-apievangelist-phrasing:
      intent: Post a JSON-RPC message to an MCP sub-path
      effect: write
      questions:
      - Can I send MCP JSON-RPC calls to a path below /api/mcp/ instead of the root?
      - Which handler receives POSTs on nested MCP routes?
      instructions:
      - text: POST my MCP JSON-RPC message to sub-path {path} under /api/mcp/.
        slots:
          path: path.path
      - text: Call an MCP tool by posting to a nested MCP route.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp/{path}'].delete
  update:
    x-apievangelist-phrasing:
      intent: End an MCP session on a sub-path
      effect: destructive
      questions:
      - How do I close an MCP session that was opened on a nested /api/mcp/ path?
      - Does a DELETE on an MCP sub-path terminate the session?
      instructions:
      - text: Terminate my MCP session with a DELETE to sub-path {path} under /api/mcp/.
        slots:
          path: path.path
      - text: Close the streamable-http session on a nested MCP route.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp/{path}'].patch
  update:
    x-apievangelist-phrasing:
      intent: Send a PATCH to an MCP sub-path
      effect: write
      questions:
      - Are PATCH requests to nested /api/mcp/ routes handled?
      - What does an MCP sub-path do with a PATCH?
      instructions:
      - text: Send a PATCH request to MCP sub-path {path} under /api/mcp/.
        slots:
          path: path.path
      - text: Issue PATCH on a nested MCP route.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp/{path}'].head
  update:
    x-apievangelist-phrasing:
      intent: Check an MCP sub-path with HEAD
      effect: read
      questions:
      - Can I check that a nested MCP route is reachable without fetching a body?
      - Does HEAD work on paths under /api/mcp/?
      instructions:
      - text: Send a HEAD request to MCP sub-path {path} under /api/mcp/.
        slots:
          path: path.path
      - text: Probe a nested MCP route with HEAD.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/api/mcp/{path}'].options
  update:
    x-apievangelist-phrasing:
      intent: Run a CORS preflight on an MCP sub-path
      effect: read
      questions:
      - Will the CORS preflight pass for a nested /api/mcp/ route?
      - Which methods are allowed on MCP sub-paths according to OPTIONS?
      instructions:
      - text: Send an OPTIONS preflight to MCP sub-path {path} under /api/mcp/.
        slots:
          path: path.path
      - text: Check allowed methods on a nested MCP route with OPTIONS.
      method: generated
      generated: '2026-10-01'