BillingFree to call

buy_credits

Buy credits (payment link or crypto invoice)

Start a credit purchase: Stripe checkout link (human needed) or crypto invoice with a raw wallet address an agent can pay autonomously.

Get an API key + 100 free credits Connect the MCP server

When an agent uses buy_credits

Use buy_credits when get_credits shows the balance is too low to finish a job. With method "stripe" it returns a checkout_url that a human must open to enter card details. With method "crypto" plus a currency (BTC, ETH, LTC, USDT, USDC) it returns a raw wallet address and amount — which a fully autonomous agent can pay from a wallet with no browser and no human; credits are added automatically once the payment confirms. Prefer crypto for hands-off top-ups.

REST endpoint

POST /api/v1/billing

Credit cost

Free to call

Input schema

Field	Type	Required	Description
`package_id`	string	required	The package id to buy (from get_packages).
`method`	enum	optional	Payment method: 'stripe' (card link, needs a human) or 'crypto' (wallet-payable invoice). Default stripe.
`currency`	enum	optional	For crypto: the coin to pay in (BTC, ETH, LTC, USDT, USDC); returns a raw wallet address.

Call it over MCP

An MCP client invokes the tool with a tools/call request. Hosted clients send this to https://verifly.email/mcp with your Authorization: Bearer vf_… header; the verifly-mcp-server package does the same with VERIFLY_API_KEY set.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "buy_credits",
    "arguments": {
      "package_id": "starter",
      "method": "crypto",
      "currency": "USDT"
    }
  }
}

Posting that same call straight to the hosted endpoint:

curl -s -X POST "https://verifly.email/mcp" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"buy_credits","arguments":{"package_id":"starter","method":"crypto","currency":"USDT"}}}'

Equivalent raw REST call

Under the hood this tool calls POST /api/v1/billing. If you are not using MCP, hit the REST API directly:

curl -s -X POST "https://verifly.email/api/v1/billing" \
  -H "Authorization: Bearer vf_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"package_id":"starter","method":"crypto","currency":"USDT"}'

What you get back

For stripe: a checkout_url + session_id. For crypto: a checkout_url and, with a currency, a raw wallet address + amount + qr_code an agent can pay directly.

Required input: package_id.

Related tools

get_packages

List the credit packages available for purchase — id, credits, USD price, and price per 1k. Free.

Open get_credits

Check the API key’s remaining verification credits, recent usage, and plan. Free.

Open register_account

Create a brand-new Verifly account with no human in the loop — returns an API key and free starter credits.

Open

Use buy_credits in your agent

Verifly is the only email verifier with a hosted MCP server plus autonomous agent self-registration. An agent can call register_account for an instant key and 100 free credits, then start calling buy_credits — no human, no dashboard.

Connect the MCP server Read the agent guide