agents.json generator
Paste an OpenAPI spec URL or raw JSON/YAML and get a ready-to-paste, spec-valid agents.json. Operations without operationId are reported because agents.json can only address OpenAPI operations by operationId.
Last updated
What the generator emits
The output follows the real Wildcard schema: top-level agentsJson, info, sources, and flows. It does not emit a top-level name field and does not emit auth, because neither field exists in the schema.
Why operationId matters
agents.json references OpenAPI operations only by operationId. It cannot point to an operation by HTTP method and path, so an OpenAPI operation without operationId cannot be represented. This generator surfaces those skipped operations plainly and never invents ids that were not present in your source spec.
After you generate it
Review the source path and generated flows, publish the file at /agents.json or /.well-known/agents.json, then validate the live agents.json.
Frequently asked questions
- What does the agents.json generator create?
- It converts an OpenAPI document into a Wildcard v0.1.0 agents.json manifest with the required top-level agentsJson, info, sources, and flows fields. Each generated flow references the source OpenAPI operation by its real operationId.
- Does the generator invent missing operationIds?
- No. agents.json addresses OpenAPI operations only by operationId, not by path and method. Operations without operationId cannot be represented, so the generator reports them as skipped instead of fabricating ids.
- Can I paste raw OpenAPI JSON or YAML?
- Yes. You can paste raw JSON or YAML directly. URL input fetches the OpenAPI document server-side with SSRF protection; raw text input needs no network fetch.
- Does agents.json include authentication details?
- No. The Wildcard agents.json schema has no auth field. Authentication stays in the linked OpenAPI security schemes and credentials are supplied at runtime by the agent or client.
- Where should I publish the generated file?
- Publish the reviewed manifest at /agents.json or /.well-known/agents.json, keep the source OpenAPI URL reachable, then validate the live file with the agents.json validator.