BillingFree

get_packages

List buyable credit packages

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

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

When an agent uses get_packages

Use get_packages before buy_credits to pick the right top-up: it returns each package’s id, credit amount, USD price, and price per 1k credits. An agent that knows how many emails it needs to verify can choose the cheapest package that covers the job. Pass the returned id straight to buy_credits.

REST endpoint

GET /api/v1/billing?action=packages

Credit cost

Free

Input schema

This tool takes no arguments — call it with an empty arguments object.

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": "get_packages",
    "arguments": {}
  }
}

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":"get_packages","arguments":{}}}'

Equivalent raw REST call

Under the hood this tool calls GET /api/v1/billing?action=packages. If you are not using MCP, hit the REST API directly:

curl -s "https://verifly.email/api/v1/billing?action=packages" \
  -H "Authorization: Bearer vf_your_api_key"

What you get back

A JSON object with a packages array (id, credits, price, price_per_credit, popular) and crypto_available.

Related tools

buy_credits

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

Open get_credits

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

Open get_usage

Usage over a period (day / week / month): credits, emails, requests by endpoint and source, daily breakdown. Free.

Open

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

Connect the MCP server Read the agent guide