GETGet Agent Card

Fetch the hosted A2A AgentCard for a registered agent. Returns raw AgentCard JSON (A2A spec §4.4) so A2A clients can consume it directly.

Summary

Metaplex hosts an A2A AgentCard for agents registered through the app. EIP-8004 consumers discover this endpoint through the agent's services[] entry.

• Returns the AgentCard exactly as stored — no response envelope
• Supports conditional requests via ETag / If-None-Match (304 Not Modified)
• Returns 404 when the agent has no hosted card

Quick Reference

Endpoint

GET /agents/{address}/agent-card.json

Path Parameters

Query Parameters

Example Request

curl "https://api.metaplex.com/v1/agents/7nE9GvcwsqzYcPUYfm5gxzCKfmPqi68FM7gPaSfG6EQN/agent-card.json"

Response

An A2A AgentCard object:

{
  "name": "Example Agent",
  "description": "An autonomous trading agent.",
  "url": "https://api.metaplex.com/v1/agents/7nE9.../agent-card.json",
  "version": "1.0.0",
  "capabilities": { "streaming": false },
  "skills": [
    {
      "id": "trade",
      "name": "Trade tokens",
      "description": "Executes token swaps on Solana.",
      "tags": ["solana", "trading"]
    }
  ],
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"]
}

Conditional Requests

The response includes an ETag header. Send it back as If-None-Match to receive 304 Not Modified when the card is unchanged:

curl -H 'If-None-Match: "m3k9x1"' \
  "https://api.metaplex.com/v1/agents/7nE9.../agent-card.json"

Errors

Notes

• This endpoint intentionally has no success envelope — the body is the AgentCard itself, per the A2A discovery convention.
• Cards are either authored by the agent creator at mint time or synthesized from the agent's registration metadata.