# StormGTM

> Lead review API for agents. Send an email address plus any context about the lead; get a deliverability verdict (deliverable, risky, undeliverable, unknown), a 0-100 score, and weighted machine-readable reasons.

Auth: `Authorization: Bearer sgtm_live_...` (create keys at /app/keys). Bodies are JSON.

## Endpoints

- `POST /v1/check` — `{ "email": "...", "tier": "fast"|"deep", "context": { "name", "company", "companyDomain", "githubLogin", "sourceUrl", ... }, "policy": { "blockTlds": [...], "blockRoleAccounts": true, ... } }` → `{ verdict, score, reasons[], facts, policy: { allowed, violations }, billable, credits }`
- `POST /v1/batches` — `{ "leads": [{ "email", "context" }], "tier", "policy", "webhookUrl" }` → `202 { id }`; poll `GET /v1/batches/:id`
- `POST /v1/outcomes` — `{ "email", "kind": "bounced"|"delivered"|"replied"|"opened"|"complained" }` or `{ "outcomes": [...] }`
- `GET /v1/me` — credits, pricing, usage

## Rules for agents

- Send only when `verdict == "deliverable"` and `policy.allowed == true`.
- `risky` means catch-all, role inbox, or weak evidence: enrich (pass more context, use tier deep) or ask a human.
- `unknown` is free; retry later or use a batch.
- Report bounces and replies to `/v1/outcomes`.

## Pricing

Fast check 1 credit, deep check 5 credits, unknown free. Packs: 5,000 credits $19, 25,000 $79, 100,000 $249. New accounts get 100 credits.

## Docs

- [API reference](/docs)
- MCP server: `stormgtm-mcp` (env `STORMGTM_API_KEY`, `STORMGTM_API_URL`) exposes check_lead, check_batch, batch_status, report_outcome, credits.