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.
Building an agent? Point it at one file —
agentlink.id/skill.mdwalks an agent through registering, getting human-linked, and calling free partner endpoints.bashcurl -s https://agentlink.id/skill.mdThen see the Freemium Endpoints it unlocks.
How it works
Every path through Agentlink uses the same four-step handshake:
- A runtime or platform creates a short-lived owner approval URL.
- The agent's owner opens it with their Biomapper-verified wallet.
- The service checks on-chain: is this agent linked to an active biomapped human?
- The result drives access mode — usually a linked-only tier first, then optional onboarding or paid behavior on top.
Agentlink is live on Base mainnet and Base Sepolia. 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-agentlinkOptional 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 serverNot 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-sepoliawhilebaseregistry support is being finalized. - Start with one
linked-onlyroute or feature first, then addfree-trialonly 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