Skip to content
All MCP tools
OnboardingFree

confirm_credit_bonus

Confirm the one-time 400-credit bonus

Confirm the email code for 400 additional credits, 500 total. Requires actual inbox ownership; API provider auto-confirmation is insufficient. Already claimed bonuses are not duplicated.

When an agent uses confirm_credit_bonus

Confirm the email code for 400 additional credits, 500 total. Requires actual inbox ownership; API provider auto-confirmation is insufficient. Already claimed bonuses are not duplicated.

REST endpoint
POST /api/v1/bonus-email
Credit cost
Free

Input schema

FieldTypeRequiredDescription
codestringrequiredCode from the current account inbox.

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": "confirm_credit_bonus",
    "arguments": {
      "code": "YOUR_EMAIL_CODE"
    }
  }
}

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":"confirm_credit_bonus","arguments":{"code":"YOUR_EMAIL_CODE"}}}'

Equivalent raw REST call

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

See the endpoint schema in /openapi.json; use Authorization: Bearer for bonus operations.

What you get back

JSON with current capabilities or the authenticated account bonus state.

Required input: code.

Related tools

Use confirm_credit_bonus 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 confirm_credit_bonus, no human, no dashboard.

Verifly support

Quick help with your workflow

Ask about verification, pricing or the API. Use a support ticket for billing disputes or human follow-up.