Tool Actions

These actions connect the agent to the 0xGasless Tool Gateway — a paid tool marketplace (backed by Apify’s actor ecosystem) where discovery is free and each run costs a small x402 payment from the agent’s custodied wallet, settled on Avalanche.

Browse the available tools with live prices in the Dashboard → Tool Gateway page.

search_tools — free

Find a tool for a task.

Argument	Type	Description
query	string	What you need done, e.g. "scrape google maps".
limit	number	Optional. Max results (default 10).

Returns tool ids with titles and descriptions; feed an id to call_tool.

call_tool — paid

Run a gateway tool. The gateway answers 402 with a price; the action pays it (within your cap) and returns the tool’s output dataset.

Argument	Type	Description
toolId	string	The tool id from search_tools, e.g. apify~google-search-scraper.
input	object	Optional. The tool’s input (tool-specific — e.g. a crawler wants { startUrls: [{ url }] }).
maxValue	string	Required. Payment cap in atomic units ("1000000" = 1.00 USDC max).

browse_web — paid

A convenience wrapper around call_tool with the gateway’s web-browser tool (apify~rag-web-browser): give it a URL to read or a search query, get back page content ready for the LLM. Costs ~$0.05–0.10 per call; maxValue defaults to "500000" (0.50 USDC).

http_request — free, guarded

For public, unpaid APIs — a plain HTTPS request without spinning up a paid tool. Hardened against misuse: https-only, private/loopback/link-local/cloud- metadata addresses blocked (SSRF), response size capped, optional allowlist via OXGAS_HTTP_ALLOWLIST. If the endpoint answers 402, the action tells the LLM to use pay_api instead.

Configuration

Env var	Meaning
OXGAS_TOOL_GATEWAY_URL	Override the gateway base URL (default https://dashboard.0xgasless.com, i.e. the public gateway).
OXGAS_HTTP_ALLOWLIST	Comma-separated hostnames http_request may reach (empty = any public host).