# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for TextQL MCP Service API
  version: 1.0.0
extends: openapi/textql-mcpservice-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: 7
- target: $.paths['/textql.rpc.public.mcp.MCPService/ClearOAuthToken'].post
  update:
    x-apievangelist-phrasing:
      intent: Clear an MCP server's OAuth token
      effect: destructive
      questions:
      - How do I disconnect my OAuth login from an MCP server?
      - Can I force an MCP server to re-authorize?
      instructions:
      - text: Clear the OAuth token for MCP server {server_id}.
        slots:
          server_id: requestBody.serverId
      - text: Sign me out of MCP server {server_id}.
        slots:
          server_id: requestBody.serverId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.mcp.MCPService/DeleteMCPServer'].post
  update:
    x-apievangelist-phrasing:
      intent: Delete an MCP server
      effect: destructive
      questions:
      - How do I remove an MCP server from TextQL?
      - Is deleting an MCP server different from disabling it?
      instructions:
      - text: Delete MCP server {id}.
        slots:
          id: requestBody.id
      - text: Remove the MCP server {id} permanently.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.mcp.MCPService/GetMCPServers'].post
  update:
    x-apievangelist-phrasing:
      intent: List configured MCP servers
      effect: read
      questions:
      - Which MCP servers are connected to my workspace?
      - What tool servers can TextQL call right now?
      instructions:
      - text: List my MCP servers.
      - text: Show all configured MCP servers, timing out after {timeout_ms} ms.
        slots:
          timeout_ms: header.Connect-Timeout-Ms
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.mcp.MCPService/HandleOAuthCallback'].post
  update:
    x-apievangelist-phrasing:
      intent: Complete an MCP server's OAuth flow
      effect: write
      questions:
      - What do I do with the code returned after authorizing an MCP server?
      - How is the OAuth callback finished for an MCP connection?
      instructions:
      - text: Complete OAuth for MCP server {server_id} with code {code} and state {state}.
        slots:
          server_id: requestBody.serverId
          code: requestBody.code
          state: requestBody.state
      - text: Exchange authorization code {code} for MCP server {server_id}.
        slots:
          code: requestBody.code
          server_id: requestBody.serverId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.mcp.MCPService/InitiateOAuthFlow'].post
  update:
    x-apievangelist-phrasing:
      intent: Start OAuth for an MCP server
      effect: write
      questions:
      - How do I authorize TextQL to use an MCP server that needs OAuth?
      - Where do I get the login link for an MCP server?
      instructions:
      - text: Start the OAuth flow for MCP server {server_id}.
        slots:
          server_id: requestBody.serverId
      - text: Get me the authorization link for MCP server {server_id}.
        slots:
          server_id: requestBody.serverId
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.mcp.MCPService/ToggleMCPServer'].post
  update:
    x-apievangelist-phrasing:
      intent: Enable or disable an MCP server
      effect: write
      questions:
      - Can I temporarily switch off an MCP server?
      - Is there an on/off toggle for an MCP server?
      instructions:
      - text: Toggle MCP server {id}.
        slots:
          id: requestBody.id
      - text: Switch MCP server {id} on or off.
        slots:
          id: requestBody.id
      method: generated
      generated: '2026-10-01'
- target: $.paths['/textql.rpc.public.mcp.MCPService/UpsertMCPServers'].post
  update:
    x-apievangelist-phrasing:
      intent: Add or update MCP servers
      effect: write
      questions:
      - How do I add a new MCP server to TextQL?
      - Can I update several MCP server configurations at once?
      instructions:
      - text: Add or update MCP servers {mcp_servers}.
        slots:
          mcp_servers: requestBody.mcpServers
      - text: 'Save these MCP server configurations: {mcp_servers}.'
        slots:
          mcp_servers: requestBody.mcpServers
      method: generated
      generated: '2026-10-01'