NEUS Docs

Every registered NEUS agent has a public card — identity, controller, and capabilities other apps can check before they trust it.

Discovery paths

Path	URL	Returns
Agent page	`https://neus.network/agent/{agentId}`	Human-readable profile
Universal JSON	`https://neus.network/api/agent/{agentId}?format=json`	Identity + permissions + proofs
A2A (per agent)	`https://neus.network/api/agent/{agentId}?format=a2a`	Agent-to-Agent card
A2A (platform)	`https://neus.network/.well-known/a2a/agent-card.json`	Platform-wide A2A card
EIP-8004 (platform)	`https://neus.network/.well-known/agent-card.json`	Ethereum registry card
EIP-8004 (per agent)	`https://api.neus.network/.well-known/agent-card.json?agentId={agentId}`	Per-agent ERC-8004 bridge

Per-agent EIP-8004 cards resolve to GET https://api.neus.network/api/v1/agents/card/{agentId}. The platform A2A card is also available at /api/agent/config?format=a2a.

Examples

# Human profile
# https://neus.network/agent/my-support-agent

# Full NEUS JSON
curl https://neus.network/api/agent/my-support-agent?format=json

# A2A card for this agent
curl https://neus.network/api/agent/my-support-agent?format=a2a

# Platform A2A card
curl https://neus.network/.well-known/a2a/agent-card.json

What a card shows

Field	Source	Visible
`agentId`	Identity receipt	Public
`agentWallet`	Identity receipt	Public
`agentLabel`	Identity receipt	Public
`description`	Identity receipt	Public
`capabilities`	Identity receipt	Public
`skills`	Identity receipt	Public
`controllerWallet`	Permission receipt	Public
`scope`	Permission receipt	Public
`allowedActions`	Permission receipt	Owner-view only
`deniedActions`	Permission receipt	Owner-view only

Public cards do not expose full allow/deny lists. External callers see who the agent is and who approved it — not the full permission matrix.

Platform A2A card

The platform card includes registered skills, MCP / REST / payment interfaces, auth options (OAuth and profile access keys for servers), and supported networks (Base and Solana CAIP-2 ids).

Cross-chain identifiers

Network	CAIP-2
Base Sepolia	`eip155:84532`
Base Mainnet	`eip155:8453`
Solana Mainnet	`solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp`
Solana Devnet	`solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1`

CORS and caching

Discovery endpoints return Access-Control-Allow-Origin: *. Platform cards cache for about an hour; per-agent cards cache for about five minutes.

How to use it

Discover — fetch the card for the agent you need.
Confirm — check the permission receipt before a sensitive action.
Connect — call the agent through MCP, A2A, or your own runtime.

Agent identity

Team agents

One approving account, many agents.

Connect agent context

Mount a verified agent into a project.

MCP

Check receipts and resolve agents at runtime.

Agent Trust

Discover agents

Discovery paths

Examples

What a card shows

Platform A2A card

Cross-chain identifiers

CORS and caching

How to use it

Next

Agent identity

Team agents

Connect agent context

MCP

​Discovery paths

​Examples

​What a card shows

​Platform A2A card

​Cross-chain identifiers

​CORS and caching

​How to use it

​Next

Agent identity

Team agents

Connect agent context

MCP

Discovery paths

Examples

What a card shows

Platform A2A card

Cross-chain identifiers

CORS and caching

How to use it

Next