Framework Integrations

Use these official adapters when you want your agent to have native tools for checking linked-human status instead of calling the raw query client directly.

Best for: Self-Hosted Agent Operators and hosted platforms that support these frameworks.

These adapters are built on top of @techdigger/humanode-agentlink and work on both base-sepolia (testnet) and base (mainnet).

LangChain

pnpm add @techdigger/humanode-agentlink-langchain langchain

import { createAgent } from 'langchain'
import { createBiomapperLangChainTools } from '@techdigger/humanode-agentlink-langchain'

const agent = createAgent({
	model,
	tools: createBiomapperLangChainTools({
		network: 'base-sepolia',
		registryAddress: '0xYourRegistry',
	}),
})

These tools give your LangChain agent the ability to query Agentlink status directly from prompts. The agent can call check_agent_status, get_current_generation, and get_biomapper_info as native tool calls — no manual SDK wiring needed.

Tools exposed:

• check_agent_status
• get_current_generation
• get_biomapper_info

Vercel AI SDK

pnpm add @techdigger/humanode-agentlink-ai-sdk ai

import { streamText } from 'ai'
import { createBiomapperAISDKTools } from '@techdigger/humanode-agentlink-ai-sdk'

const result = await streamText({
	model,
	prompt: 'Check whether 0x1234... is linked to a biomapped human.',
	tools: createBiomapperAISDKTools({
		network: 'base-sepolia',
		registryAddress: '0xYourRegistry',
	}),
})

The Vercel AI SDK adapter exposes the same three tools as the LangChain adapter, surfaced as AI SDK-compatible tool definitions. Pass them to streamText, generateText, or any other AI SDK entry point that accepts tools.

MCP

Use the MCP server when your host already speaks stdio MCP:

pnpm dlx @techdigger/humanode-agentlink-mcp

MCP client example:

{
	"mcpServers": {
		"biomapper": {
			"command": "pnpm",
			"args": ["dlx", "@techdigger/humanode-agentlink-mcp"]
		}
	}
}

The MCP package exports createBiomapperMcpServer when you want to compose the server yourself. This is the right choice for Claude Desktop, Cursor, CrewAI, or any MCP-compatible host.

Shared defaults

All three adapters use the same query primitives from @techdigger/humanode-agentlink. Set these once to avoid repeating them across adapters:

const sharedDefaults = {
	network: 'base-sepolia' as const,
	registryAddress: '0xYourRegistry',
	rpcUrl: 'https://your-rpc-endpoint', // optional: override public RPC
}

// Then pass to any adapter:
createBiomapperLangChainTools(sharedDefaults)
createBiomapperAISDKTools(sharedDefaults)

Next steps

• Back to agent setup → Self-Hosted Agent Operators
• Raw SDK entry points → Package Reference