AGENTUTIL
DocsChangelogGet Key
Docs→Getting Started

Quick Start

Make your first AgentUtil API call in 2 minutes.

The Pattern

Every AgentUtil tool follows the same pattern:

  1. POST to create a task (pay with x402 or API key)
  2. Poll with the poll_token until complete
  3. Get the result
POST /v1/tools/{tool}/tasks → { task_id, poll_token, poll_url }
GET  /v1/tasks/{task_id}    → { status, result }

Example: Geocode an Address

1. Create a Task

curl -X POST https://api.agentutil.dev/v1/tools/geo.locate/tasks \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_your_api_key" \
  -d '{"address": "1600 Amphitheatre Parkway, Mountain View, CA"}'

Response:

{
  "task_id": "task_abc123",
  "poll_token": "pt_eyJhbGci...",
  "status": "pending",
  "poll_url": "/v1/tasks/task_abc123"
}

2. Poll for Result

Use the poll_token to check status:

curl https://api.agentutil.dev/v1/tasks/task_abc123 \
  -H "Authorization: Bearer pt_eyJhbGci..."

Response (when complete):

{
  "id": "task_abc123",
  "tool": "geo.locate",
  "status": "complete",
  "result": {
    "latitude": 37.4220,
    "longitude": -122.0841,
    "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
  }
}

Authentication Options

Option 1: x402 Micropayments (Recommended)

No signup. Your agent pays per request with USDC on Base.

  1. Call the API without auth
  2. Get 402 with payment requirements
  3. Sign payment with wallet
  4. Retry with payment proof
  5. Get poll_token in response

Best for: AI agents that need to pay autonomously

→ Set up a wallet

Option 2: API Key

Get an API key and include it in every request:

Authorization: Bearer sk_live_xxxxx

Best for: Testing, traditional integrations

→ Get an API key

Poll Tokens

When you create a task, you get a poll_token that's valid for 24 hours. Use it to poll task status without needing an API key or wallet signature.

Authorization: Bearer pt_xxxxx

This is especially useful for x402 payments — you pay once to create the task, then poll freely with the token.

Available Tools

  • dns.lookup — $0.005 — DNS records for any domain
  • email.verify — $0.01 — Email deliverability check
  • ip.geolocate — $0.01 — IP to location + threat info
  • geo.locate — $0.005 — Address to coordinates
  • url.status — $0.005 — Check if URL is reachable
  • homeservices.search — $0.02 — Find local service pros

Next Steps

Set Up a Wallet →