# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Free Tools API
  version: 1.0.0
extends: openapi/agoragentic-com-free-tools-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 10
- target: $.paths['/tools/echo'].get
  update:
    x-apievangelist-phrasing:
      intent: Echo a message with a free GET
      effect: read
      questions:
      - Can I echo a message back using a simple query string?
      - Is there an anonymous GET for the echo utility?
      instructions:
      - text: Echo back the message {message} via GET.
        slots:
          message: query.message
      - text: Call the echo utility with a GET request.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/echo'].post
  update:
    x-apievangelist-phrasing:
      intent: Test API connectivity with echo
      effect: read
      questions:
      - How can I confirm my agent can reach the Agoragentic API?
      - Is there a free endpoint that returns whatever I post to it?
      instructions:
      - text: Post a test payload to echo to check connectivity.
      - text: Verify my connection by posting to the echo tool.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/uuid'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the free UUID utility
      effect: read
      questions:
      - Is there an anonymous GET version of the UUID tool?
      - Can I hit the UUID utility without any spend?
      instructions:
      - text: Call the UUID utility with a GET request.
      - text: Read the free uuid endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/uuid'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a unique identifier
      effect: read
      questions:
      - Can I get a fresh unique ID from a free tool?
      - Where can my agent generate a UUID for free?
      instructions:
      - text: Generate a new UUID.
      - text: Give me a unique identifier by posting to the UUID tool.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/fortune'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the free fortune utility
      effect: read
      questions:
      - Is the fortune utility available as a no-spend GET?
      - Does the fortune GET count as a paid invocation?
      instructions:
      - text: Call the fortune utility with a GET request.
      - text: Read the free fortune endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/fortune'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a random fortune
      effect: read
      questions:
      - Can I get a random wisdom quote for my agent?
      - Is there a free tool that returns a fortune?
      instructions:
      - text: Give me a random fortune.
      - text: Post to the fortune tool for a wisdom quote.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/palette'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the free palette utility
      effect: read
      questions:
      - Is there an anonymous GET for the palette utility?
      - Can I reach the palette tool without spending anything?
      instructions:
      - text: Call the palette utility with a GET request.
      - text: Read the free palette endpoint.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/palette'].post
  update:
    x-apievangelist-phrasing:
      intent: Generate a harmonious color palette
      effect: read
      questions:
      - Can a free tool suggest a set of colors that go well together?
      - Where can I generate a color palette for a design?
      instructions:
      - text: Generate a harmonious color palette.
      - text: Post to the palette tool to get a new set of colors.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/md-to-json'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the free md-to-json utility
      effect: read
      questions:
      - Is the markdown-to-JSON utility reachable with a plain GET?
      - Does a GET to md-to-json cost anything?
      instructions:
      - text: Call the md-to-json utility with a GET request.
      - text: Read the free md-to-json endpoint description.
      method: generated
      generated: '2026-09-26'
- target: $.paths['/tools/md-to-json'].post
  update:
    x-apievangelist-phrasing:
      intent: Convert markdown to structured JSON
      effect: read
      questions:
      - Can I turn a markdown document into structured JSON for free?
      - What does markdown look like once it's converted to JSON?
      instructions:
      - text: 'Convert this markdown to JSON: {markdown}.'
        slots:
          markdown: requestBody.markdown
      - text: Parse {markdown} into structured JSON.
        slots:
          markdown: requestBody.markdown
      method: generated
      generated: '2026-09-26'