OnboardingFree (no API key required)

register_account

Self-register a new account + API key

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

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

When an agent uses register_account

register_account is how an agent bootstraps itself with zero human involvement: give it an email and a password (min 8 chars; disposable domains are rejected) and it creates an account pre-loaded with free credits and returns a freshly generated API key. The key is shown ONCE — capture and store it immediately. Every subsequent tool call uses that key as the bearer token. This is the entry point of the fully autonomous flow: register → verify → top up with crypto if needed.

REST endpoint

POST /api/v1/autonomous/register

Credit cost

Free (no API key required)

Input schema

Field	Type	Required	Description
`email`	string	required	Email for the new account (not a disposable domain).
`password`	string	required	Password for the new account (minimum 8 characters).

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": "register_account",
    "arguments": {
      "email": "my-agent@example.com",
      "password": "a-strong-password"
    }
  }
}

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":"register_account","arguments":{"email":"my-agent@example.com","password":"a-strong-password"}}}'

Equivalent raw REST call

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

curl -s -X POST "https://verifly.email/api/v1/autonomous/register" \
  -H "Content-Type: application/json" \
  -d '{"email":"my-agent@example.com","password":"a-strong-password"}'

What you get back

A JSON object with the new account id/email and an api_key.key shown ONCE — store it; it cannot be retrieved again. The account starts with free credits.

Required inputs: email, password.

Related tools

get_account

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

Open get_credits

Check the API key’s remaining verification credits, recent usage, 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 register_account 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 register_account — no human, no dashboard.

Connect the MCP server Read the agent guide