Skip to content

README.md

Latest commit

 

History

History
172 lines (126 loc) · 9.82 KB

README.md

File metadata and controls

172 lines (126 loc) · 9.82 KB

NEUS

Trust infrastructure for apps, agents, and ecosystems.
Trust that travels. Add reusable trust receipts before access, payment, or agent action.

npm License Discussions

Why NEUS | Start building | Live surfaces

What NEUS is

NEUS turns identity, ownership, authority, risk, content, and actions into reusable trust receipts. Your app or agent can check a receipt before allowing access, payment, tool use, delegation, or audit-sensitive work.

Use the hosted url when you want NEUS to own the flow. Use the SDK, widgets, API, or MCP when you want the receipt inside your product, backend, or agent workflow.

Why NEUS

Trust keeps getting rebuilt inside each app, marketplace, workflow, and agent stack. NEUS is trust infrastructure for apps, agents, and ecosystems — reusable receipts instead of restarting from zero:

Need NEUS gives you
Stop re-building trust from zero A receipt your product can save, check, and reuse
Bring Your Own Agent (BYOA) CLI-assisted import for existing local agent setups
Gate access or rewards Hosted flows, widgets, and server checks for trusted access
Trust agents before they act Agent identity, scoped delegation, and receipts for trusted actions
Audit what happened Proof pages, receipt reads, tags, and durable references
Ship without owning ceremony Hosted Verify, SDK helpers, API checks, and MCP on the same trust model

Start building

1. Bring Your Own Agent (BYOA)

If you already have an AI agent configured locally, the NEUS CLI can package supported local agent context from OpenClaw, Cursor, Claude Code, or Claude Desktop:

npx -y -p @neus/sdk neus import

This writes a local portable-agent manifest. In MCP, call neus_agent_link first; if setup is missing, use neus_agent_create, complete the hosted or signing steps, then call neus_agent_link again until linked: true.

2. Add trust to an app

Use Hosted Verify, VerifyGate, or the SDK when your app needs a reusable trust receipt.

3. Add trust to an agent

Use NEUS when an agent needs identity, scoped authority, and receipts for trusted actions.

4. Connect AI assistants

Install NEUS in Cursor, Claude Code, or Codex — same identity, delegation, and receipts as your apps. Other MCP hosts: NEUS for AI assistants.

npx -y -p @neus/sdk neus setup
npx -y -p @neus/sdk neus auth
npx -y -p @neus/sdk neus doctor --live

Sign in with neus auth (OAuth). Profile access keys are for servers and CI only — see MCP setup.

Topic Link
Install hub NEUS for AI assistants
Tools and session order MCP overview
Discovery URLs (server card, .well-known) Discovery and endpoints

Hosted MCP URL: https://mcp.neus.network/mcp

Live surfaces

Surface Use it for
Hosted Verify Browser verification at neus.network/verify
Trust receipts Reusable receipt IDs, proof pages, profile surfaces, and eligibility
SDK Verification, polling, hosted URLs, and server-side gate checks
Widgets VerifyGate and ProofBadge for React products
API Server reads, checks, verifier catalog, and verification endpoints
Agents Agent identity, delegation, stable URLs, and action receipts
MCP Live trust context for assistants, tools, and agent workflows

Start here

Path Best next step
First app integration Quickstart
Build a flow Integration
React gate VerifyGate
Server/API API overview
Agent trust Agents overview
Assistants/MCP MCP setup

Capability snapshot

The live verifier catalog is documented at docs.neus.network/verification/verifiers. JSON Schemas live in docs/verifiers/schemas/; the machine index is spec/VERIFIERS.json.

Capability Verifiers
Ownership and identity ownership-basic, ownership-social, ownership-dns-txt, ownership-org-oauth, ownership-pseudonym
Human and wallet trust proof-of-human, wallet-risk, wallet-link
Assets and contracts token-holding, nft-ownership, contract-ownership
Content and safety ai-content-moderation
Agent trust agent-identity, agent-delegation

This repository

Docs, SDK (@neus/sdk), widgets, examples, specs, and the NEUS Trust editor plugin.

Where to go next

Proof of reality

Surface Link
Product neus.network
Hosted Verify neus.network/verify
Docs docs.neus.network
SDK npm: @neus/sdk
MCP discovery npm: @neus/mcp-server
Examples examples/
Verifier catalog Verifier docs

Support

Channel Use for
Docs Product and integration guidance
Changelog Release notes and upgrade paths
Platform status Maturity, beta scope, upgrade expectations
Discussions Questions and implementation patterns
Issues Bugs and requests
dev@neus.network Security

See CONTRIBUTING.md for contribution guidance.

License

  • SDK and tools: Apache-2.0
  • Smart contracts: BUSL-1.1 to Apache-2.0 in August 2028