agent402-llamaindex

Drop-in LlamaIndex TS tools for Agent402 — the open-source, self-hostable x402 + MCP server with 500+ pay-per-call web tools (browser, web search, PDF, images, live data, payment helpers, wallet-keyed memory).

Agent402 is the applied layer of Agentic Finance - agents that pay and get paid on their own over the two open wires, x402 and MPP (Machine Payments Protocol). Every paid endpoint answers both on the same 402; wallet-only tools take any payment-wrapped fetch (@x402/fetch, or a stock mppx fetch).

• Zero new infra. Get back a ready-to-pass FunctionTool[] array for any LlamaIndex agent.
• Free tier by default. No wallet needed — compute-payable tools settle with a built-in proof-of-work.
• Wallet-only tools optional. Pass an @x402/fetch-wrapped fetch to use the full catalog.
• Raw JSON Schema. No Zod or manual schema authoring needed.

Install

npm install llamaindex agent402-llamaindex

Use with the OpenAI agent

import { OpenAIAgent } from "llamaindex";
import { agent402Tools } from "agent402-llamaindex";

const { tools } = await agent402Tools({ slugs: ["extract", "hash", "render", "screenshot"] });

const agent = new OpenAIAgent({ tools });
const res = await agent.chat({ message: "Get the title of https://example.com/article" });
console.log(res.response);

Use with a Workflow

import { agent } from "llamaindex";

const { tools } = await agent402Tools({ slugs: ["hash"] });
const myAgent = agent({ tools });
const res = await myAgent.run("Compute SHA-256 of 'hello world'");

Pay with USDC (wallet-only tools)

const { tools } = await agent402Tools({
  freeOnly: false,
  fetch: payFetch, // your @x402/fetch-wrapped fetch
});

Self-hosted Agent402

const { tools } = await agent402Tools({ baseUrl: "https://agent402.example.com" });

Trust & baseUrl

The catalog server you point baseUrl at controls the name, description, and JSON Schema of every generated tool — and tool descriptions are passed to your LLM. Only point baseUrl at an Agent402 instance you operate or trust. The default (https://agent402.tools) is the maintained, open-source hosted instance.

License

MIT