API Evangelist conversational phrasing for APIs.io Providers API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for APIs.io Providers API
  version: 1.0.0
extends: openapi/apis-io-providers-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['/providers'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse and filter API providers
      effect: read
      questions:
      - Which providers are tagged payments and publish an OpenAPI?
      - Can I filter providers by band, score range or trend?
      - Which providers score above 80 on a single facet?
      instructions:
      - text: List providers tagged {tags}.
        slots:
          tags: query.tags
      - text: Show providers in {region} with a composite score between {min_score} and {max_score}.
        slots:
          region: query.region
          min_score: query.min_score
          max_score: query.max_score
      - text: Find providers whose {facet} facet is at least {min_facet}.
        slots:
          facet: query.facet
          min_facet: query.min_facet
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one provider's profile
      effect: read
      questions:
      - What does the catalog know about a single provider, including its links and APIs?
      - Can I get just a few fields of one provider's profile?
      instructions:
      - text: Get the provider profile for {slug}.
        slots:
          slug: path.slug
      - text: Fetch {fields} for provider {slug}.
        slots:
          fields: query.fields
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}/apis'].get
  update:
    x-apievangelist-phrasing:
      intent: List the APIs a provider publishes
      effect: read
      questions:
      - What APIs does a given provider publish?
      - Can I list only a provider's APIs that have an AsyncAPI?
      instructions:
      - text: List the APIs published by {slug}.
        slots:
          slug: path.slug
      - text: Show {slug}'s APIs tagged {tags}.
        slots:
          slug: path.slug
          tags: query.tags
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}/artifacts'].get
  update:
    x-apievangelist-phrasing:
      intent: Get every artifact a provider publishes
      effect: read
      questions:
      - What artifacts does a provider publish across all its APIs, in one call?
      - Does a provider have an Arazzo or pricing artifact anywhere in its APIs?
      instructions:
      - text: Get every artifact {slug} publishes, grouped by type.
        slots:
          slug: path.slug
      - text: Aggregate all artifacts across {slug}'s APIs.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}/onboarding'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a provider's getting-started details
      effect: read
      questions:
      - 'How do I get started with a provider: signup, docs, auth and base URLs?'
      - Where is a provider's developer portal and signup page?
      instructions:
      - text: Show the getting-started view for {slug}.
        slots:
          slug: path.slug
      - text: Get the signup, docs and base URLs for {slug}.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}/similar'].get
  update:
    x-apievangelist-phrasing:
      intent: Find alternatives to a provider
      effect: read
      questions:
      - What alternatives exist to a provider I'm evaluating?
      - Which providers overlap most with one in tags, industry and region?
      instructions:
      - text: Find providers similar to {slug}.
        slots:
          slug: path.slug
      - text: Show {limit} alternatives to {slug}.
        slots:
          limit: query.limit
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}/capabilities'].get
  update:
    x-apievangelist-phrasing:
      intent: Count what a provider publishes
      effect: read
      questions:
      - How many of each artifact type does a provider publish?
      - Which agent dimensions does a provider's public surface satisfy?
      instructions:
      - text: Count what {slug} publishes by artifact type.
        slots:
          slug: path.slug
      - text: Show the agent dimensions {slug} satisfies.
        slots:
          slug: path.slug
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}/operations'].get
  update:
    x-apievangelist-phrasing:
      intent: List every operation a provider exposes
      effect: read
      questions:
      - What operations can I actually call on a provider, across all its specs?
      - Can I find the operations a provider marks deprecated?
      - Which of a provider's operations move money rather than just read data?
      instructions:
      - text: List every operation {slug} exposes.
        slots:
          slug: path.slug
      - text: Show {slug}'s {method} operations whose path contains {path}.
        slots:
          slug: path.slug
          method: query.method
          path: query.path
      - text: Find operations in {slug} with agentic consequence {consequence}.
        slots:
          slug: path.slug
          consequence: query.consequence
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}/tools'].get
  update:
    x-apievangelist-phrasing:
      intent: List the MCP tools a provider ships
      effect: read
      questions:
      - What MCP tools does a provider ship, and which operation does each wrap?
      - Can I see only first-party MCP tools, not derived candidates?
      instructions:
      - text: List the MCP tools {slug} ships.
        slots:
          slug: path.slug
      - text: Show {slug}'s MCP tools with provenance {provenance}.
        slots:
          slug: path.slug
          provenance: query.provenance
      method: generated
      generated: '2026-09-26'
- target: $.paths['/providers/{slug}/schema'].get
  update:
    x-apievangelist-phrasing:
      intent: List a provider's JSON Schemas
      effect: read
      questions:
      - What data shapes does a provider's API work in?
      - Can I search one provider's JSON Schemas by name?
      instructions:
      - text: List every JSON Schema {slug} publishes.
        slots:
          slug: path.slug
      - text: Find schemas matching {q} in {slug}'s APIs.
        slots:
          q: query.q
          slug: path.slug
      method: generated
      generated: '2026-09-26'