Agent-Readiness Grade

Agent-Readiness Grade / Tools / agent-card.json generator

A2A agent card generator

Fill in the form and the agent card updates as you type, following the A2A 1.0.0 AgentCard object: required fields (name, description, supportedInterfaces, version, capabilities, default input and output modes, skills) are checked, and authentication is written as A2A 1.0 security schemes. Runs in your browser; nothing you type is sent.

Checked 2026-09-30 against grader version 1.3.0 and the A2A 1.0.0 specification.

Agent name (required) description (required)

version (required)

documentationUrl (optional)

iconUrl (optional)

Interface (supportedInterfaces[0], protocolVersion 1.0) url (required; https for HTTP bindings) protocolBinding

Provider (optional: both or neither)

organization

url

Capabilities and modes streaming pushNotifications extendedAgentCard (an authenticated extended card is available)

defaultInputModes (media types, comma-separated)

defaultOutputModes (media types, comma-separated)

Authentication Scheme

API key location

API key header, query or cookie name

Bearer format hint (optional, for example JWT)

OAuth authorizationUrl

OAuth tokenUrl

OAuth scopes (one per line: scope: description) OpenID Connect discovery URL

Only the fields for the chosen scheme are used.

Skill 1

id (required)

name (required)

description (required) tags (comma-separated, required) examples (one per line, optional)

Skill 2 (optional)

id (required)

name (required)

description (required) tags (comma-separated, required) examples (one per line, optional)

Skill 3 (optional)

id (required)

name (required)

description (required) tags (comma-separated, required) examples (one per line, optional)

Skill 4 (optional)

id (required)

name (required)

description (required) tags (comma-separated, required) examples (one per line, optional)

Skill 5 (optional)

id (required)

name (required)

description (required) tags (comma-separated, required) examples (one per line, optional)

Updates as you type when JavaScript is on.

Your agent-card.json

agent-card.json

Download agent-card.json

Publish it at https://your-host/.well-known/agent-card.json with Content-Type: application/json, a Cache-Control header and an ETag (A2A 1.0 section 8.6). The card is public: never put credentials in it.

What this does

A2A 1.0.0 field names and required fields (specification section 4.4)
Interfaces with JSONRPC, HTTP+JSON or GRPC binding
Authentication: none, API key, HTTP bearer, OAuth 2.0 authorization code with PKCE, OpenID Connect
Up to five skills with tags and examples
Copy and download as agent-card.json

Guide for this file: agent-card.json: publish an A2A agent card at /.well-known (A2A 1.0). Other generators: llms.txt generator · robots.txt for AI crawlers · security.txt generator.

Check your site

After publishing, grade the site to see what a crawler sees.

$49 AI Visibility Full Report

The fixes on this site are free. The paid next step is the $49 AI Visibility Full Report (what ChatGPT, Claude and Perplexity say about your brand, with a prioritized fix list) from aivisibility.agentexchange.work. It includes:

8 real buyer questions tested across ChatGPT-class models
Competitor share-of-voice: who AI names, how often, versus you
Full GEO site audit with prioritized, specific fixes
Agent-Readiness Score: crawler access, llms.txt, schema, discovery manifest
Custom 30/60/90-day action plan to get cited by ChatGPT, Perplexity and Google AI Overviews
Shareable report, generated in about 60 seconds after checkout

Get the Full Report — $49 Stripe checkout; you enter your brand and site right after paying.