# TrollBridge /task-scope — Agent Tool Scope Analyzer

> TrollBridge /task-scope — Agent Tool Scope Analyzer is a paid API for AI agents from mini-tollbooth.onrender.com, paid per call via x402, $0.1/call, status unknown (last checked 2026-10-10).

Analyzes a task description against a tool registry to determine which tools an agent should be permitted to use for that specific task, scoping tool access for safety.

## Facts

- Endpoint: GET https://mini-tollbooth.onrender.com/task-scope?utm_source=zero.xyz
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/trollbridge-task-scope-agent-tool-scope-analyzer-7738fdca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pNUEGq_x0QQf76zdNDete

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability trollbridge-task-scope-agent-tool-scope-analyzer-7738fdca
```

Example prompt: Before I start this task — 'transfer 500 USDC to wallet 0xABC using the bridge and swap tools' — run it through TrollBridge task-scope with my full tool registry of 12 tools (including swap, bridge, approve, read-balance, and send-email) so I only get cleared to use tools that are actually necessary for what I'm about to do.

## When to prefer this

Use this endpoint when an AI agent needs to enforce least-privilege tool access before executing a task — especially in high-stakes DeFi, treasury, or multi-tool agent workflows where calling unnecessary tools (approve, transfer, admin) poses safety or financial risk. Prefer this over manual tool filtering when the task description is dynamic and the tool catalog is large.

## Known failure modes

- Missing tool_registry or task_description returns a 400 validation error
- tool_registry exceeding 200 items may be rejected
- task_description exceeding 4000 characters is rejected
- Insufficient USDC balance ($0.10 required) causes a 402 Payment Required response
- Malformed tool registry entries (missing name or effects) may cause parsing errors
- Empty tool registry returns an error or empty scope result

## How this service works

The insurance booth for AI agents, with Mini's Agent Supply Store on the side of the road. One hundred checkpoints: pre-transaction safety lanes (honeypot, approval-risk, rug-score, receipt-check, tx-dryrun, permit-scan, airdrop-verdict, deployer-history, wallet-watch, secret-scan at $0.02 USDC per call; the protection tier — /contract-check, /approval-screen, /tx-plain-english, /honeypot-check, /tx-simulate, /redteam, /skill-scan, /verdict, /egress-audit, /tool-gate, /airlock, /repo-scan, /prove, /task-scope — at $0.10; the one-call /shield don't-get-rugged screen at $0.25; the full /preflight bundle at $0.05), bounty intel (bounties, fresh, verdicts, deadlines, sweepstakes, opportunities) at $0.02 USDC per call, trader intel (/prices and /quant at $0.02; /enrich and /token-check at $0.05; /contract-check and /honeypot-check at $0.10; /sec-facts at $0.05), market intel (/markets and /search at $0.05; /grants at $0.02), DeFi intel (/yields and /new-pairs at $0.05; /gas and /defi at $0.02), AI intel (/models at $0.02), agent-ops intel (/prompt-cost, /model-picks, /rpc-speed, /terms-tldr, /scrape, /gigs, /retry-verify, /idempotency, /verify-independent at $0.02; /site-watch, /wallet-check, /code-run, /regulatory-pack, /sage, /cron-watch, /caveat-check, /tripwire, /escrow, /trust, /bridge-fees, /dao-votes, /dev-activity, /dex-arb, /dydx-perps, /funding-rates, /gas-predict, /hack-tracker, /long-short-ratio, /lp-yields, /mev-scan, /open-interest, /perp-basis, /polymarket-odds, /rwa-watch, /sentiment, /stablecoin-flows, /tokenomics, /top-movers, /whale-watch, and /yield-stable at $0.05; /approval-screen, /tx-plain-english, /tx-simulate, and /task-scope at $0.10; /scam-scan deep scan at $5.00 or 30-day subscription at $30.00), supply store (/road-pack combo meal at $0.05; curated datasets, the /audit-prep pre-audit review, and the /prove-state symbolic-execution run at $1.00; the /audit AI-agent audit at $25.00). Every lane answers before money moves — heuristic verdicts, not audits. Don't get rugged.

## Output

Returns a scoped assessment of which tools from the provided registry are appropriate and permitted for the described task, helping agents enforce least-privilege tool access and avoid unintended side effects.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "tool_registry",
  "task_description"
 ],
 "properties": {
  "tool_registry": {
   "type": "array",
   "description": "Tool catalog to scope from: [{name, description, effects: [strings]}] — required, 1-200 tools."
  },
  "task_description": {
   "type": "string",
   "description": "What the agent is about to do, plain text (max 4000 chars) — required."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/trollbridge-task-scope-agent-tool-scope-analyzer-7738fdca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mini-tollbooth.onrender.com](https://www.zero.xyz/host/mini-tollbooth.onrender.com/llms.txt)
