Skip to main content
Register an agent; agent wallet signs. Proof skills are metadata only - they do not install MCP servers - MCP overview. Prefer portable skill ids (spec, directory). Default: neus_agent_create (MCP) or hosted verify. Below = SDK detail. Verifier ID: agent-identity

Basic Registration

const proof = await client.verify({
  verifier: 'agent-identity',
  data: {
    agentId: 'my-assistant',
    agentWallet: '0x...',
    agentChainRef: 'eip155:8453',
    agentType: 'ai',
    description: 'My AI assistant',
  },
  walletAddress: agentWallet,
});
You can supply chain context either in data as agentChainRef (CAIP-2) or on the verification request as chain (CAIP-2) or chainId (EVM). Those options satisfy the same requirement. Field names and limits: Fields (below). JSON Schema: agent-identity.json.

Full Example

await client.verify({
  verifier: 'agent-identity',
  data: {
    agentId: 'my-agent',
    agentWallet: '0x...',
    agentChainRef: 'eip155:8453',
    agentType: 'ai',
    description: 'My AI assistant',
    capabilities: { search: true, mcp: true },
    instructions: 'System and operating instructions (max 16000 chars)',
    skills: [
      { id: 'web-search', kind: 'mcp' },
      { id: 'vercel-react-best-practices', kind: 'plugin' },
    ],
    services: [
      { name: 'metrics', endpoint: 'https://metrics.example.com/v1', version: '1.0' },
    ],
  },
  walletAddress: agentWallet,
});

Fields

FieldRequiredMax LengthDescription
agentIdYes1 - 128 charsUnique identifier for the agent
agentWalletYes-Agent wallet address (EVM or Solana)
agentChainRefYes in data, or set chain or chainId on the verification request-CAIP-2 chain reference for agentWallet
agentLabelNo128 charsHuman-readable display name
agentTypeNoenumai, bot, service, automation, or agent
descriptionNo500 charsAgent description
capabilitiesNo-Boolean flags (search, mcp, proofs, …) - see schema
instructionsNo16000 charsSystem prompt, tool/connector policy, output format, and safety/PII handling; portable in the signed identity
skillsNo48 objectsEach object requires id; optional kind, label, …
servicesNo16 itemsname + endpoint (+ optional version)

What you get

Verification id. Signed with the agent wallet. No spend or permission grants - use agent-delegation for scoped authority.

Verification

GET /api/v1/proofs/check?verifierIds=agent-identity&address=0x...