Skip to main content
NEUS publishes A2A (Agent-to-Agent Protocol) agent cards so automation, partner integrations, and multi-agent systems can discover capabilities, endpoints, and trust receipts without hardcoding.

​
Discovery endpoints

EndpointFormatUse
https://neus.network/.well-known/a2a/agent-card.jsonA2A v1.0.0Platform-wide discovery URL
https://neus.network/api/agent/config?format=a2aA2A v1.0.0Same platform card (explicit API route)
https://neus.network/.well-known/agent-card.jsonEIP-8004Ethereum-ecosystem platform registration (static)
https://api.neus.network/.well-known/agent-card.json?agentId={agentId}EIP-8004Per-agent registration (redirects to agent card API)
https://neus.network/api/agent/{agentId}?format=a2aA2A v1.0.0Per-agent dynamic card
https://neus.network/api/agent/{agentId}?format=jsonNEUS universalFull identity + delegation + proofs
Per-agent EIP-8004 cards resolve to GET https://api.neus.network/api/v1/agents/card/{agentId}.

​
Platform A2A card

curl "https://neus.network/.well-known/a2a/agent-card.json"
The live response includes:
  • Skills — platform-registered skill IDs (for example verification, mcp-tools) with A2A descriptions
  • Interfaces — MCP (2025-11-25), REST (v1), x402 payments
  • Security — OAuth-first MCP setup, NEUS access keys for servers/CI, and receipt references (qHash) for trust-gated endpoints
  • Networks — Base Sepolia (eip155:84532), Base Mainnet (eip155:8453), Solana Mainnet, Solana Devnet
Fetch the card and read the returned skills array.

​
Per-agent card

curl "https://neus.network/api/agent/my-agent?format=a2a"
NEUS resolves the agent’s latest identity and delegation proofs, then returns an A2A card scoped to that agent’s registered skills and capabilities.

​
Cross-chain identifiers

NEUS A2A extensions include chain IDs in CAIP-2 format:
NetworkCAIP-2
Base Sepoliaeip155:84532
Base Mainneteip155:8453
Solana Mainnetsolana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
Solana Devnetsolana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1

​
Format matrix

FormatEndpointWhen to use
A2A (platform)/.well-known/a2a/agent-card.jsonGoogle A2A / multi-agent discovery
A2A (platform, API)/api/agent/config?format=a2aSame card via explicit route
A2A (per agent)/api/agent/{id}?format=a2aAgent-scoped A2A card
EIP-8004 (platform)/.well-known/agent-card.jsonEthereum registry / ERC-8004 wallets
EIP-8004 (per agent)https://api.neus.network/.well-known/agent-card.json?agentId={id}Per-agent ERC-8004 bridge
NEUS universal/api/agent/{id}?format=jsonFull proof records, identity, delegation

​
CORS and caching

All discovery endpoints return:
  • Access-Control-Allow-Origin: * — safe for browser-based agent UIs
  • Cache-Control: public, max-age=3600, stale-while-revalidate=7200 (platform); max-age=300 (per-agent)

​
Next steps

Agent identity

Register an agent so it appears in per-agent discovery.

MCP

Use NEUS MCP tools to check proofs and resolve agents at runtime.

Cookbook

End-to-end agent setup with identity + delegation.
Last modified on June 8, 2026