# Agent Preflight

> Pre-execution decisions for budgeted AI agents. Evaluates a proposed search/browse tool call and returns allow | block | reuse | defer | advise. Never executes the destination tool.

Canonical site: https://agent-preflight.com
Canonical API: https://api.agent-preflight.com
Price: $0.001 USDC per HTTP POST on POST /v0.2/preflight/tool-call (Base mainnet x402 in production)

## Endpoints
- GET https://api.agent-preflight.com/health
- GET https://api.agent-preflight.com/openapi.json
- POST https://api.agent-preflight.com/v0.2/preflight/tool-call
- POST https://api.agent-preflight.com/check-request (unpaid)
- MCP https://api.agent-preflight.com/mcp (unpaid)

## Docs
- https://agent-preflight.com/docs
- https://agent-preflight.com/llms-full.txt
- https://api.agent-preflight.com/openapi.json

## Notes
- Unpaid production POSTs to the tool-call route return 402 with PAYMENT-REQUIRED.
- Analytics use hashed run/step IDs; raw IDs and bodies are not stored in Analytics Engine points.
- No safety or savings guarantees.

## Decision meanings
- allow: Proceed with the proposed tool/API call.
- block: Do not execute; the call looks invalid, unsupported, or proven wasteful.
- reuse: Skip a new call and reuse a recent successful result when available.
- defer: Do not execute now; usually budget-infeasible or not worth spending yet.
- advise: Optional narrowing advice; not a hard stop. Not billed as an actionable decision fee in economics.

## Example request body
```json
{
  "runId": "run_01",
  "stepId": "step_7",
  "tool": {
    "provider": "search",
    "operation": "web_search",
    "request": { "query": "Acme Corp Series B funding", "max_results": 5 },
    "estimatedExternalCostUsd": 0.01,
    "estimatedModelCostUsd": 0.002
  },
  "budget": {
    "remainingUsd": 0.08,
    "reservedUsd": 0.02,
    "maxToolCallsRemaining": 4
  },
  "task": { "goalHash": "goal-acme" },
  "history": []
}
```

## Example curl (expects 402 without payment in production)
```bash
curl -i -X POST https://api.agent-preflight.com/v0.2/preflight/tool-call \
  -H 'content-type: application/json' \
  -H 'accept: application/json' \
  --data @body.json
```

## What is evaluated
- Supported tools: search/web_search, browse/fetch
- Request schema validity
- Budget remaining vs estimated external cost
- Optional history for duplicates and terminal retries
- Optional capabilities for reuse / scope reduction

## Payment behavior (production)
- Network: Base mainnet (eip155:8453)
- Asset: USDC
- Amount: $0.001 per POST
- Protocol: x402
- check-request and MCP remain free