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