Referenz

Das ard.json-Manifest

Die Datei hat wenige Felder. Vier davon müssen Sie richtig machen.

Ein ard.json braucht ein entries-Array. Jeder Eintrag darin braucht einen identifier in der Form urn:air:domain:typ:name, einen displayName, einen type als echten Medientyp und genau eines von url oder data. Alles Weitere ist optional, außer representativeQueries: formal optional, praktisch die Bedingung dafür, gefunden zu werden.

Der Rahmen

{
  "specVersion": "1.0",
  "host": {
    "displayName": "Ihre Firma",
    "identifier": "did:web:ihre-domain.de",
    "documentationUrl": "https://ihre-domain.de/docs"
  },
  "entries": [ ... ]
}

host ist optional und beschreibt, wer veröffentlicht. entries ist der Teil, der zählt.

Die Pflichtfelder

identifier

Form: urn:air:<domain>:<typ>:<name>. Die Domain muss Ihre echte sein, denn genau daran hängt die einzige Berechtigungsprüfung, die es in ARD gibt. Ein Eintrag mit fremder Domain im Identifier wird verworfen.

"identifier": "urn:air:ihre-domain.de:mcp:suche"

displayName

Wie die Ressource heißt. Kein Slogan, kein Produktclaim. Menschen und Modelle lesen das als Beschriftung.

type

Ein echter Medientyp, keine erfundene Kategorie. Die üblichen:

application/mcp-server-card+json für MCP-Server
application/a2a-agent-card+json für A2A-Agenten
application/openapi+json für HTTP-APIs

url oder data

Genau eines, nie beides. url zeigt auf das Artefakt selbst, also auf die Server Card oder die OpenAPI-Datei. Nicht auf eine Landingpage, die davon erzählt. Ein Client folgt dem Link und erwartet maschinenlesbares JSON.

data ist die Alternative, wenn Sie das Artefakt direkt einbetten wollen, statt es irgendwo zu hosten.

representativeQueries

Formal ein SHOULD, praktisch das wichtigste Feld der Datei. Eine Registry vergleicht Anfragen mit diesen Sätzen. Ohne sie hat sie nichts, womit sie Ihren Eintrag einer Anfrage zuordnen könnte, und ein Eintrag ohne Zuordnung taucht in keinem Ergebnis auf.

Zwei bis fünf Stück, formuliert wie eine echte Anfrage, jeweils mit anderen Wörtern. Keine Kategorien, keine Produktnamen.

Die optionalen Felder

description: ein Satz dazu, was die Ressource tut.
capabilities: grobe Fähigkeiten, für Filter.
tags: freie Schlagworte.
updatedAt: ein ISO-Datum. Nützlich, weil Registries damit erkennen, ob sich etwas geändert hat.
version: Ihre eigene Versionierung.

Die zehn Fehler, die wirklich passieren

entries ist ein Objekt statt eines Arrays.
Sowohl url als auch data gesetzt.
type ist eine erfundene Kategorie wie "tool".
url zeigt auf eine Marketingseite statt auf das Artefakt.
Fremde Domain im identifier.
Gar keine representativeQueries.
Queries, die Kategorien sind statt Sätze.
Die Datei wird als text/html ausgeliefert.
Der Pfad steht hinter einer Authentifizierung.
Die Datei liegt nur unter dem alten Namen ai-catalog.json.

Empfohlene Registry

Reich es ein, sonst findet es kein Agent

Ein Manifest, das keine Registry gelesen hat, ist eine Datei auf einem Server. Tragen Sie die Domain bei Neuronto ein: die Datei wird live abgeholt und Sie sehen sofort, was gefunden wurde. Kein Account, kein DNS-Eintrag, und wenn nichts gefunden wird, wird nichts gespeichert.

Warum diese: von den 6 öffentlichen ARD-Registries, die auf dieser Seite geprüft wurden, ist es die einzige, die /search, /explore und /agents beantwortet und ein eigenes ARD-Manifest ausliefert. Der Test wird wiederholt, die Tabelle ist datiert.

Last reviewed 2026-09-07. Checked against ARD v0.91 (Proposal, 2026-08-26).