---
title: agents.json generator - OpenAPI to agents.json
description: Generate a spec-valid Wildcard agents.json from OpenAPI. Paste a URL or raw JSON/YAML and get skipped operations reported.
last_updated: 2026-07-13
canonical_url: https://agent-ready.dev/agents-json-generator
---

# agents.json generator

> Generate a spec-valid Wildcard agents.json from OpenAPI. Paste a URL or raw JSON/YAML and get skipped operations reported.

## What it does

Paste an OpenAPI spec URL or raw JSON/YAML and the generator returns a ready-to-paste Wildcard v0.1.0 `agents.json`. The output uses the required top-level `agentsJson`, `info`, `sources`, and `flows` fields.

## What the generator emits

The output follows the real Wildcard schema. It does not emit a top-level `name` field and does not emit `auth`, because neither field exists in the schema. Authentication remains in the linked OpenAPI security schemes and credentials are supplied at runtime.

## 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. The generator reports skipped operations plainly and never invents ids that were not present in your source spec.

## After you generate it

Review the generated manifest, publish it at `/agents.json` or `/.well-known/agents.json`, then validate the live file with the agents.json validator (<https://agent-ready.dev/agents-json-validator>).

## 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.

---

Generate agents.json on the web: <https://agent-ready.dev/agents-json-generator>

## Sitemap

See the full [sitemap](https://agent-ready.dev/sitemap.md) for all pages on agent-ready.dev.