# Proof Inbox

Email verification credits for Grok Bots. Money moves only on the checkout page.
Credits change only in the ledger. The bot talks to MCP.

## MCP

https://mcp.proofinbox.com/mcp

Streamable HTTP. Tools: balance, verify_email, receipts.
Auth: pass workspace_token in the tool arguments, or Authorization: Bearer <workspace_token>.

## Install prompt

Use MCP https://mcp.proofinbox.com/mcp.
Tools: balance, verify_email, receipts.
If a tool returns payment_required, open checkout_url, complete Link checkout, wait for credits, retry.
Save workspace_token and reuse it.
Never invent verify results. If status is unknown, say unknown.
After a pack purchase, call receipts and show me the Stripe session id.

## Loop

1. Call balance. If verify credits are 0, you will need to buy.
2. verify_email on the first address, or go straight to buy.
3. On payment_required, open checkout_url (do not invent one).
4. Human approves the Link charge.
5. Poll balance every 2 seconds for about 30 seconds until credits cover the batch.
6. Call verify_email once per address.
7. When asked what the money bought, call receipts. Show the Stripe session id. Do not invent it.

## Checkout

- https://proofinbox.com/buy/verify-500?workspace=<workspace_token> — $9, 500 credits
- https://proofinbox.com/buy/verify-100?workspace=<workspace_token> — $5, 100 credits

If there is no workspace yet, visiting checkout creates one and puts the token in the URL.
Save that token.

## verify_email result

status is only: valid | invalid | catch_all | unknown
unknown means the SMTP/vendor check did not finish. Do not call that valid.

## Credit rules

- Purchase verify_100: +100
- Purchase verify_500: +500
- Fresh verify_email: −1
- Cached verify_email (same address, 30 days): 0
- balance / receipts: 0
- Vendor outage or timeout (status unknown): 0
- Invalid syntax (not-an-email): 0

## HTTP mirrors (same JSON as the tools)

POST https://proofinbox.com/api/tools/balance
POST https://proofinbox.com/api/tools/verify_email
POST https://proofinbox.com/api/tools/receipts

## What you must not do

- Do not invent verify results.
- Do not invent Stripe session ids.
- Do not create a new workspace after the first checkout unless the human asks.
- Do not send email. This product only verifies.