Configure

OpenAPI discovery

Every project publishes a generated OpenAPI document that tells agents what your API does and how to pay for it.

Discovery URLs

# Project-scoped discovery URL
https://agent-proxy.alchemy.com/v1/{projectId}/openapi.json

# Alternate discovery URL
https://agent-proxy.alchemy.com/openapi.json?projectId={projectId}

What the document contains

  • The public AgentPay routes for each enabled endpoint.
  • Request and response schemas, and any parameters you configured.
  • x-payment-info metadata listing the accepted payment protocols and prices.

Writing good descriptions

Agents read your descriptions

Agents rely on endpoint names, descriptions, parameter schemas, and response schemas to decide whether your API is the right tool for a task. Keep them specific and current.