LlamaIndex TS

Install

npm install llamaindex agent402-llamaindex

Example

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);

What it exposes

• One native tool per catalog slug you pass in slugs (a short list gives the model better tool selection).
• With no slugs, the free-tier catalog: every compute-payable tool (freeOnly: true is the default).
• An execute(name, args) function that runs a tool call and pays for it underneath.
• baseUrl points the adapter at a self-hosted Agent402 instance.

How payment works

• Free tier: compute-payable tools settle with a sha256 proof-of-work solved in-process. No wallet, no API key.
• Wallet-only tools (browser, network, memory, live data): set freeOnly: false and pass a payment-wrapped fetch. An @x402/fetch fetch pays in USDC over x402; a stock mppx fetch pays over MPP. The same 402 carries both offers.
• Prices come from the live catalog at /api/pricing and are quoted in every 402 before anything is signed.

const { tools } = await agent402Tools({
  freeOnly: false,
  fetch: payFetch, // your @x402/fetch-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

Every tool, price and input schema: the catalog.

Links

agent402-llamaindex on npm · source on GitHub · configuration reference
Guides: Make your AI agent pay for what it needs: x402 in 5 minutes · Durable memory for AI agents - no accounts, the wallet is the identity
All integrations