FurlPay for LlamaIndex

Give your LlamaIndex agents a wallet. This package exposes the FurlPay API as a LlamaIndex tool spec — so an agent can check balances, create checkouts, move stablecoins, place investment orders, and pay for x402-protected APIs within a spending budget.

FurlPay is the open-source financial OS for the agentic internet: stablecoin payments + the first Solana-native x402 facilitator. This is the LlamaIndex binding for it.

Maintained by FurlPay · MIT licensed.

Install

pip install furlpay-llamaindex

Quickstart

from furlpay_llama import FurlPayToolSpec
from llama_index.core.agent import ReActAgent

tools = FurlPayToolSpec().to_tool_list()   # reads FURLPAY_API_KEY from the environment
agent = ReActAgent.from_tools(tools, llm=llm)

Zero-config: with no FURLPAY_API_KEY set, every tool runs in demo mode — reads return deterministic sample data and writes simulate without touching the network. Wire up your agent and watch the tool calls before you ever create an account. Set the key to go live against https://api.furlpay.com/v1.

export FURLPAY_API_KEY=fp_live_sk_...          # optional; omit for demo mode
export FURLPAY_API_BASE=https://sandbox.api.furlpay.com/v1   # optional sandbox

Tools

⚡ pay_for_resource is the headline: it lets an agent buy metered data or API access over x402 — the payment primitive API keys can't express — while set_agent_budget keeps it from overspending.

Full agent example

from llama_index.core.agent import ReActAgent
from llama_index.llms.anthropic import Anthropic
from furlpay_llama import FurlPayToolSpec

tools = FurlPayToolSpec().to_tool_list()
agent = ReActAgent.from_tools(tools, llm=Anthropic(model="claude-sonnet-5"), verbose=True)
agent.chat("Buy $25 of VOO and cap my x402 budget at $50/day.")

A runnable version is in examples/agent.py:

pip install "furlpay-llamaindex[examples]"
python examples/agent.py

Use an explicit client

from furlpay_llama import FurlPayClient, FurlPayToolSpec

client = FurlPayClient(api_key="fp_live_sk_...", base_url="https://api.furlpay.com/v1")
tools = FurlPayToolSpec(client).to_tool_list()

The spec subclasses BaseToolSpec, so it also plugs into LlamaIndex workflows, FunctionCallingAgent, and anything else that consumes a tool list.

Test

pip install "furlpay-llamaindex[dev]"
python -m pytest tests -q        # or, no pytest:  python tests/test_tool_spec.py

The suite runs in demo mode and asserts the tool contract: the spec converts to a well-formed FunctionTool list, every declared spec_function is exposed with metadata, each is callable and returns serialisable output, and the x402 budget guard refuses to overspend.

Scope

This package orchestrates FurlPay's public API into LlamaIndex tools. It doesn't custody funds or sign transactions itself — wallets, MPC custody, brokerage (via Alpaca), and x402 settlement all happen in the FurlPay API. Point it at your own FurlPay account and it operates on your data.

License

MIT