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