# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Dynamicfeed Ai verified facts API
  version: 1.0.0
extends: openapi/dynamicfeed-ai-verified-facts-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: 6
- target: $.paths['/v1/state-of-mcp'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the signed State of MCP census
      effect: read
      questions:
      - How many MCP servers exist right now, and how many are remote or keyless?
      - Is there a signed, primary-source count of the MCP ecosystem?
      instructions:
      - text: Show the latest State of MCP census.
      - text: Get the signed count of MCP servers in the official registry.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/state-of-mcp/trend'].get
  update:
    x-apievangelist-phrasing:
      intent: Get State of MCP growth over time
      effect: read
      questions:
      - How has the number of MCP servers grown over recent weeks?
      - Is the share of remote and keyless MCP servers rising?
      instructions:
      - text: Show the State of MCP trend for the last {days} days.
        slots:
          days: query.days
      - text: Get the daily State of MCP growth series.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/facts'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a verified fact via GET
      effect: read
      questions:
      - Can I get any tool's value as a canonical fact with an honest verification block?
      - What is the difference between a signed fact and a verified one?
      instructions:
      - text: Fetch the bitcoin price as a canonical fact using the GET facts endpoint.
      - text: Get a verified-fact record for current weather with a simple GET.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/facts'].post
  update:
    x-apievangelist-phrasing:
      intent: Request a verified fact via POST
      effect: read
      questions:
      - Can I post a JSON request to the verified-fact layer instead of using GET?
      - Is there a POST form of the facts endpoint for structured requests?
      instructions:
      - text: Post a JSON request to the facts endpoint for a corroborated value.
      - text: Use the POST facts call to get a fact with its confidence score.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/answer'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a signed answer with receipts via GET
      effect: read
      questions:
      - Can I ask a factual question and get a signed answer with its full evidence chain?
      - How is confidence computed in an answer with receipts?
      instructions:
      - text: Ask the GET answer endpoint whether the market is open and return the evidence.
      - text: Get a signed answer with receipts for my question using GET.
      method: generated
      generated: '2026-10-01'
- target: $.paths['/v1/answer'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit premises for a signed answer via POST
      effect: read
      questions:
      - Can I post structured premises and get per-premise verdicts in one signed answer?
      - Is there a POST form of answers with receipts for longer inputs?
      instructions:
      - text: Post my factual premises to the answer endpoint for signed verdicts.
      - text: Submit a JSON body of premises to get an answer/v1 object.
      method: generated
      generated: '2026-10-01'