Account & usageFree

get_usage

Get detailed usage statistics

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

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

When an agent uses get_usage

Use get_usage when an agent needs to report or reason about spend over time rather than the current balance — total credits used, emails processed, requests broken down by endpoint and source, and a daily breakdown. Useful for cost dashboards, anomaly checks, or deciding how big a top-up to buy. Costs no credits.

REST endpoint

GET /api/v1/usage?period={day|week|month}

Credit cost

Free

Input schema

Field	Type	Required	Description
`period`	enum	optional	Reporting period: day, week, or month. Default month.
`limit`	integer	optional	Max recent log entries to include (default 100, max 1000).

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_usage",
    "arguments": {
      "period": "month"
    }
  }
}

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_usage","arguments":{"period":"month"}}}'

Equivalent raw REST call

Under the hood this tool calls GET /api/v1/usage?period={day|week|month}. If you are not using MCP, hit the REST API directly:

curl -s "https://verifly.email/api/v1/usage?period=month" \
  -H "Authorization: Bearer vf_your_api_key"

What you get back

A JSON object with a summary (total_credits_used, total_emails_processed, total_requests, by_endpoint, by_source) and a daily array.

Related tools

get_credits

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

Open get_account

The account profile for the current key: email, credits, total used, key count, and plan. Free.

Open 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

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

Connect the MCP server Read the agent guide