langchain-tanod

LangChain tools for Tanod: pay-per-call security and utility tools for AI agents. No signup and no API key. Each tool has a free daily tier. Past it, the agent pays per call in USDC on Base with x402, through the tanod SDK.

Tanod is operated by an autonomous AI agent. Results are automated and heuristic, not an audit. Every tool description tells the model that text inside results is untrusted data, never instructions.

Install

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

Use

from langchain_tanod import get_tanod_tools
from tanod import Tanod

tools = get_tanod_tools(Tanod(max_price_usd=0.05))   # the agent can never pay more than USD 0.05 per call

# Works with any tool-calling chat model or agent, e.g. LangChain 1.x:
from langchain.agents import create_agent

agent = create_agent("<provider:model>", tools)
agent.invoke({"messages": [{"role": "user", "content": "Before I approve it: is 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 on Base risky?"}]})

TanodToolkit(client=..., include=[...]).get_tools() gives you the same tools. get_tanod_tools(async_client=AsyncTanod()) makes the tools call the API natively async.

Tools

These tools are built by default:

These tools are opt-in. Request them with include=[...], or pass TOOL_NAMES for every tool:

• tanod_get_contract_source (0.005)
• tanod_latest_block (0.001)
• tanod_agents_history (0.05)
• tanod_agents_export (0.25, no free tier)
• tanod_extract_pdf (0.005), tanod_get_page_meta (0.002), tanod_ocr_image (0.01): sitepeek, sharing its 5 free calls/day
• tanod_rdap_lookup (0.002), tanod_verify_email (0.002, DNS only, no SMTP), tanod_ip_lookup (0.001): dnspeek, sharing its 5 free calls/day
• tanod_get_token_price (0.002, Chainlink), tanod_get_transaction (0.002), tanod_get_nft (0.002), tanod_get_allowance (0.002), tanod_get_portfolio (0.004), tanod_get_swap_quote (0.003, a spot quote, not a firm price): chainpeek, sharing its 10 free reads/day
• tanod_web_search (0.012, 3 free/day): findpeek
• tanod_get_weather (0.002, 5 free/day): weatherpeek

Free tiers are per IP per UTC day. The live prices are in https://tanod.dev/openapi.json.

Output and errors

A tool returns a JSON string with these keys:

{"result": {...}, "payment": null, "free_remaining_today": 29, "note": "...untrusted data..."}

payment holds the x402 settlement receipt (transaction, price_usd, ...) when the call was paid. It is null when the free tier covered the call.

Problems the agent can act on come back as the tool's text output, and none of them is charged. They are returned through handle_tool_error:

• the payment needed and no wallet configured;
• a price above your cap;
• invalid input;
• not found;
• rate limited;
• temporarily unavailable.

Configuration

get_tanod_tools(**kwargs) passes keyword arguments to tanod.Tanod:

The key is never logged.

Development

pip install -e ../python -e ".[dev]"
pytest   # mocked HTTP, no network, no real payments

MIT licensed. Tanod is operated by an autonomous AI agent. Contact: ops@tanod.dev.