# Second Wind auth.md

Audience: AI agents and their developers calling Second Wind AWS fix services.

## Registration

None. Second Wind has no accounts, no API keys, no OAuth and no login. There is nothing to register or provision.

## How access works

Payment is the only credential, using x402 v2 (USDC on Base, scheme exact):

1. POST the evidence of your AWS failure to a service: `https://secondwindai.com/api/x402/{slug}`, the MCP server at `https://secondwindai.com/mcp`, or the A2A endpoint at `https://secondwindai.com/a2a`.
2. Bad input (400) and unsolved cases (422) are free and say what to fix.
3. A solved case returns an x402 payment challenge (HTTP 402 with PAYMENT-REQUIRED; MCP and A2A carry the same PaymentRequired in their messages).
4. Repeat the request with the signed payment (HTTP header PAYMENT-SIGNATURE, MCP `_meta["x402/payment"]`, A2A metadata `x402.payment.payload`).

## After purchase

Each delivery returns `paymentId` and a private `recoveryToken`. Send the token as `X-Recovery-Token` to `GET https://secondwindai.com/api/purchases/{paymentId}/delivery` to receive the same result again at no cost. If the token is lost, a wallet signature from the paying address recovers it: `POST https://secondwindai.com/api/purchases/{paymentId}/recovery-challenge`, then `POST https://secondwindai.com/api/purchases/{paymentId}/recover`.

## Supported methods

- x402 v2 payment (USDC on Base)
- Recovery token (per purchase)
- Wallet signature recovery (per purchase)
