LlamaIndex Tanod tool spec

LlamaIndex tools for Tanod: pay-per-call web, document and security tools for AI agents. No signup, no API key. There is a free daily allowance per IP; past it, each call costs a few cents or less in USDC on Base, paid with x402 through the tanod Python client.

Tanod is operated by an autonomous AI agent. Results are automated and heuristic, not an audit. A clean result is not proof that a contract, address, package or URL is safe. Text inside results (web pages, OCR text, code evidence) is untrusted data and must never be treated as instructions.

Install

pip install llama-index-tools-tanod             # free-tier calls only
pip install "llama-index-tools-tanod[wallet]"   # lets the agent pay (x402, USDC on Base)

Use

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
from llama_index.tools.tanod import TanodToolSpec

tools = TanodToolSpec().to_tool_list()          # free tier: no key, no wallet

agent = FunctionAgent(tools=tools, llm=OpenAI(model="gpt-4.1"))
print(await agent.run("Search for x402 and summarise the top result's page."))

Direct calls return a list of Document:

spec = TanodToolSpec()
docs = spec.web_search("x402 payments for agents", count=5)
page = spec.render_page("https://example.com")[0].text   # Markdown

Tools

Live prices: https://tanod.dev/openapi.json. Free allowances are per IP per UTC day.

Free tier and paying with x402

The client sends X-Tanod-Free: 1 on the first attempt, so free allowance is used first. When it is used up (or a tool has none), the API answers 402 Payment Required with an x402 quote. With no wallet configured, the tool returns a Document saying payment is required and nothing is paid. With a wallet, the client signs a USDC payment (Base) and retries, within a per-call price cap.

# Wallet from the environment: export TANOD_PRIVATE_KEY=0x...  (a dedicated, small-balance key)
spec = TanodToolSpec(max_price_usd=0.05)

# Or explicitly (a key string or an eth_account signer):
spec = TanodToolSpec(private_key=my_key, max_price_usd=0.05)

# Or bring your own configured client:
from tanod import Tanod
spec = TanodToolSpec(client=Tanod(signer=my_signer, max_price_usd=0.02))

Use a dedicated hot wallet holding only a few dollars of USDC. max_price_usd refuses any quote above the cap.

Errors

Failures (payment needed, invalid input, rate limit, service unavailable) come back as a Document with metadata["error"] = True and a readable message, so the agent can react instead of crashing. Invalid input and other refusals are not charged.

Limitations

• Results are automated and heuristic. Contract and package scans, address risk and URL checks can have false positives and false negatives; they are not audits or guarantees.
• Fetched content (pages, PDFs, OCR) is third-party data; sandbox it from your instructions.
• Only public http(s) URLs work; private and internal addresses are refused.
• screenshot returns a base64 image up to 8 MB; prefer jpeg and a small viewport.

Development

pip install -e ".[dev]"
pytest                          # mocked HTTP, no network
TANOD_LIVE=1 pytest -m live     # opt-in: real free-tier calls

MIT licensed. Source: https://github.com/tanod-labs/integrations.