Getting Started

Agentlink lets AI agents prove they're backed by a real, verified human so platforms can offer a trusted human-backed tier, selective linked-only access, and softer onboarding when agents pay for services via the x402 protocol.

Think of it as a verified-human badge that agents carry automatically, based on a one-time wallet approval by their owner.

How it works

Every path through Agentlink uses the same four-step handshake:

1. A runtime or platform creates a short-lived owner approval URL.
2. The agent's owner opens it with their Biomapper-verified wallet.
3. The service checks on-chain: is this agent linked to an active biomapped human?
4. The result drives access mode — usually a linked-only tier first, then optional onboarding or paid behavior on top.

Agentlink is available on Base Sepolia today, with Base mainnet tracked separately until registry deployment metadata is complete. See Profile Support for current status. Reach out to @tech_digger on Telegram for integration.

Choose your path

I want to…	I am…	Go here
Finish owner approval with the approval link I already have	A human owner approving a hosted agent	Link Your Agent
Run my own agent and get human-verified perks everywhere	Running my agent on my own server, locally, or in my own code	Self-Hosted Agent Operators
Call the two-for-one service	An agent paying $1.00 USDC and expecting AgentLink-based payout routing	Two-for-One Service
Add a human-backed agent tier to a paid agent product	A platform and x402 operator running a paid API, inference endpoint, data service, MCP tool, or similar	x402 Service Providers

If you already have the approval URL and only need the wallet step, use Link Your Agent.

Canonical audience map:

• Owner approval — finish the hosted wallet action with Link Your Agent
• Self-hosted agent operators — generate the approval URL and send signed agent requests with Self-Hosted Agent Operators
• Platform and x402 operators — issue hosted approval links and verify linked agents with x402 Service Providers

Two sides of the marketplace

For platform operators and x402 providers — you run the paid route or platform integration, issue hosted approval links, and check verified-human status in real time to decide trusted access, premium plans, and onboarding flows. This is the x402 Service Providers path.

For owner approval and agent operators — you want an agent to carry human-verified status everywhere it pays. Most self-hosted operators are also the owner: you generate the approval URL from your runtime and approve it yourself with your biomapped wallet. Use Self-Hosted Agent Operators for the full path. If you already have the URL and only need the wallet step, use Link Your Agent.

Packages

Core library — required for service providers and self-hosted operators:

pnpm add @techdigger/humanode-agentlink

Optional framework adapters — add these if you want native tool surfaces for your agent:

pnpm add @techdigger/humanode-agentlink-langchain langchain   # LangChain
pnpm add @techdigger/humanode-agentlink-ai-sdk ai             # Vercel AI SDK
pnpm dlx @techdigger/humanode-agentlink-mcp                           # MCP server

Not a developer? If your agent runs on a hosted platform, you do not need to install anything. Go to Link Your Agent.

Quick rules of thumb

• Start on base-sepolia while base registry support is being finalized.
• Start with one linked-only route or feature first, then add free-trial only where a softer onboarding funnel helps conversion.
• Keep the agent wallet, network, and registry choice inside the runtime or platform that creates the approval URL.
• If you need LangChain, AI SDK, or MCP adapters on top of the self-hosted path, see Framework Integrations.
• For the on-chain contract surface, see Contracts Reference.
• For supported profiles, see Profile Support.

Next steps

• Approving with a hosted platform wallet flow? → Link Your Agent
• Running your own agent? → Self-Hosted Agent Operators
• Building a paid service or platform flow? → x402 Service Providers
• Already have the approval URL? → Link Your Agent