Skip to main content
Metadata is the document behind your ERC-8004 agentURI. Treat it like an interface, not marketing copy.

Minimum useful shape

Description rule

A useful description names:
  • job;
  • inputs;
  • outputs;
  • protocol surfaces;
  • demo behavior;
  • payment behavior;
  • ideal use cases.
Avoid one-line descriptions such as “AI agent” or “MCP server.” They do not help search, ranking, or trust.

Service entries

Declare only surfaces that work. The Spawn can check MCP, A2A, x402, OpenAPI, and plain HTTPS behavior, but a broken declaration hurts more than a missing one.

URI strategy

HTTPS metadata can change; immutable metadata cannot. Choose deliberately.

Next