NEUS Docs

Most sessions do not need a separate neus_me call. Call neus_context first; when the connection is authenticated, it already includes signed-in profile context. Use neus_me when you need to refresh profile context, confirm a changed sign-in, or look up a public Profile by wallet/DID (Auth, Overview).

Topic	Detail
Signed-in session	Refreshes the current Profile context
URL-only MCP	Returns `auth_required` — run `neus auth` or sign in through your host
No key, user must verify	`neus_verify_or_guide`
Public identifier lookup	Pass `identifier` (wallet or DID); visibility rules apply

Input

{
  "identifier": "0x..."
}

Omit identifier to use the authenticated MCP session.

Output

`status`	Payload
`ok`	`principal` (DID, handle, primary account), optional `agents`, and optional `profileSummary`
`auth_required`	Optional `ui_url`

When present, profileSummary.proofsSummary is a compact profile snapshot with total, embeddedCount, isTruncated, byVerifier, latestByVerifier, latestByCategory, and latestByScope. Use neus_proofs_get for full paginated receipt history.

Last modified on June 9, 2026

Read Trust Receipts (`neus_proofs_get`)Agent readiness (`neus_agent_link`)

MCP Basics

Tool reference

Profile Context (`neus_me`)

Input

Output

​Input

​Output

Input

Output