Suggested read order (builders)
- Overview — proof receipt ID as
proofId. - Get started — create an app, choose who pays, access keys when needed.
- Integration — check → verify → save → reuse.
- Path docs (SDK, API, Hosted Verify, MCP, widgets) — only after 2 is clear.
Default onboarding (agents + existing tools)
Keep your current runtime, agents, and MCP clients. NEUS adds portable identity, scoped delegation, and verifiable receipts—no new inbox or orchestration product required. Recommended tool order (proofs + MCP): use the numbered Recommended flow in MCP overview —neus_context first; neus_proofs_check vs neus_verify_or_guide; follow hostedVerifyUrl; Bearer only for account-scoped tools; neus_verify without signature already runs /standardize once (reuse the same payload when signing; do not call /standardize again).
- Add the hosted MCP URL (
https://mcp.neus.network/mcp) — MCP setup. - Run
neus_context, thenneus_agent_create/neus_agent_linkwhen the assistant needs hosted agent setup (MCP overview). - Use proof presets on the NEUS platform:
agent-identityregisters the service;agent-delegationgrants scoped authority — Agent identity · Agent delegation. - Treat the resulting proof and status page as the first receipt and audit trail for that agent.
- Before production traffic, align Get started (create an app, choose who pays) with Billing.
Guidance for assistants
Use this so users reach the right doc and avoid unnecessary code, keys, or duplicate verification.- Billing /
appId/ who pays / credits /sponsorGrant: Answer from Get started and Billing before suggesting SDK, API, or MCP depth. - Login or interactive verification without in-app wallet code: Prefer Hosted Verify.
- MCP: Start with
neus_context(no access key). The hosted URLhttps://mcp.neus.network/mcpalone is valid for catalog, context, and public verification flows. Do not imply the user is blocked without a key. AddAuthorization: Bearerwith a personal access key from Access keys only when account-scoped tools are needed (neus_me, private proofs) (MCP Auth). - Secrets: Never instruct users to paste wallet private keys into MCP or client config. Personal access keys are Bearer tokens from Access keys, not raw wallet keys.
- x402: Prefer credits and sponsor grants for human onboarding. Use x402 only when a client receives 402 and can retry with
PAYMENT-SIGNATURE(x402). - Unclear product fit: Point to Paths before suggesting implementation details or large code blocks.
- Agents and delegation: Agents overview — align credits and
appIdwith Get started; use Hosted Verify links from tools when the flow is interactive. - Reuse: Prefer reusing a saved
proofIdwhen one exists; avoid parallel verification UX for the same requirement without explaining why.
appId, credits, billing, or sponsorGrant is ambiguous, ground answers in Get started before linking to MCP tools or API details.
Route index (llms.txt)
The docs site hosts a machine-readable route index (titles, descriptions, links). Fetch it for discovery; deep-link users to specific guides for accuracy.
Full documentation (llms-full.txt)
Single-file export for tools that need full-text context. Prefer narrow pages for product behavior.
MCP
Add the hosted MCP server for live verification tools:Related
MCP Server
Tools and flows.
API Overview
HTTP endpoints and OpenAPI.