LangChain.js and LangGraph

agent402-langchain · npm · MIT

LangChain.js tool objects for Agent402, ready for any LangChain or LangGraph agent. Four meta tools cover the whole catalog, so the agent's tool budget stays small however many endpoints the catalog holds.

Install

npm install agent402-langchain @langchain/core zod

Example

import { agent402Tools } from "agent402-langchain";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const tools = await agent402Tools();   // free tier: proof-of-work, no wallet
const agent = createReactAgent({ llm, tools });

What it exposes

  • agent402_find: a plain-language task in, the best-matching tools out (slug, route, price, input schema, a ready example).
  • agent402_route: ranks tools across every indexed x402 seller; include: "external" leaves this server out.
  • agent402_call: calls a tool by slug and pays for it.
  • agent402_about: the service manifest (payment options, capability map, MCP connector).
  • agent402ToolSpecs() returns the same four as framework-agnostic specs (name, description, JSON Schema, execute) with no framework dependency.

How payment works

  • Pure-CPU tools: agent402_call fetches a proof-of-work challenge and solves it in-process, so no wallet is needed.
  • Wallet-only tools: pass fetch, a payment-wrapped fetch. @x402/fetch pays in USDC over x402 on whichever chain your wallet is funded for; a stock mppx fetch pays over MPP.
  • Unpaid lookups (find, route, about) use fetchImpl and never spend anything.
const tools = await agent402Tools({ fetch: payFetch }); // an x402- or MPP-wrapped fetch

A call that fails is not charged: settlement runs after the tool and only on a successful response. Background: What x402 is · MPP (Machine Payments Protocol).

Tools to try first

Web search$0.02
search
Web answer$0.08
answer
Extract article$0.010
extract
Hash$0.001
hash
Route and execute$0.01
route-execute

Every tool, price and input schema: the catalog.

Links

agent402-langchain on npm · source on GitHub · configuration reference
Guides: One payment, any proven seller: the x402 Smart Order Router · Use Agent402 from Claude Code, Cursor, VS Code, Windsurf, Cline, Roo Code, Codex CLI, Gemini CLI, Muse Code, Continue, ElizaOS, AgentCore and any OpenAI SDK
All integrations