Skip to content

Add AgentToll action provider - #1407

Open
tevfikefeaydin wants to merge 2 commits into
coinbase:mainfrom
tevfikefeaydin:add-agenttoll-action-provider
Open

Add AgentToll action provider#1407
tevfikefeaydin wants to merge 2 commits into
coinbase:mainfrom
tevfikefeaydin:add-agenttoll-action-provider

Conversation

@tevfikefeaydin

Copy link
Copy Markdown

Description

Adds an AgentToll action provider: pay-per-call Base data over x402, paid in
USDC from the agent's wallet with no API keys or accounts.

AgentToll (https://agenttoll.app, open source MIT) is a Base-native data API
settled through the CDP facilitator. This provider exposes six typed actions:

  • scout_new_base_tokens — pools launched on Base in the last ~24h, each with
    a safety verdict already attached ($0.008)
  • check_base_token_safety — simulated buy & sell, taxes, owner powers,
    holder concentration ($0.002)
  • get_base_wallet_portfolio — everything an address holds, valued in USD ($0.003)
  • get_base_token_price — any Base token by contract address, priced from
    onchain DEX liquidity ($0.001)
  • resolve_basename — name to address + records, or address to primary name ($0.001)
  • get_market_brief — prices + Base gas + Fear & Greed in one call ($0.005)

Payment uses the same wallet-to-signer pattern as the existing x402 action
provider (walletProvider.toSigner() + registerExactEvmScheme), so no new
payment machinery is introduced. A request that fails is never charged —
settlement only happens when data is returned. Safety verdicts are
deliberately conservative: a check that could not run is never a "pass", and a
token too new to judge reports insufficient-data, never clear.

Compared to routing these calls through the generic x402 provider, the typed
actions give the model exact input schemas and descriptions of when to reach
for each tool, and require no service registration config.

Tests

Unit tests cover request building, query handling, error paths (non-ok
responses and network failures returned as structured errors, not throws),
network gating (base-mainnet only) and the base URL override:

pnpm test -- agenttoll

The underlying API paths and payment flow were verified against production
with real USDC settlements on Base mainnet via the same @x402/fetch +
registerExactEvmScheme client wiring this provider uses (e.g. settlement
0xc2bde164520f7bcc17bdc0778c3274a6494994c94938ef81291b73d053df5e94). Every
endpoint also answers unauthenticated with an x402 v2 quote for manual
inspection: curl -i https://agenttoll.app/api/base/scout.

Pay-per-call Base data over x402: new-token scout with safety verdicts, token safety checks, wallet portfolios, onchain token prices, Basename resolution and a market brief - paid in USDC from the agent wallet, no API keys. Uses the same wallet-to-signer pattern as the existing x402 provider.
@cb-heimdall

Copy link
Copy Markdown

🟡 Heimdall Review Status

Requirement Status More Info
Reviews 🟡 0/1
Denominator calculation
Show calculation
1 if user is bot 0
1 if user is external 0
2 if repo is sensitive 0
From .codeflow.yml 1
Additional review requirements
Show calculation
Max 0
0
From CODEOWNERS 0
Global minimum 0
Max 1
1
1 if commit is unverified 0
Sum 1

@github-actions github-actions Bot added documentation Improvements or additions to documentation action provider New action provider typescript labels Aug 7, 2026
The tool description and README listed $0.002 for check_base_token_safety; the endpoint charges $0.003. Also notes the deployer-history check the endpoint now runs.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action provider New action provider documentation Improvements or additions to documentation typescript

Development

Successfully merging this pull request may close these issues.

2 participants