vaaya / tools / agentmail / create_inbox

AgentMail create_inbox for AI agents

AgentMail — Provision a new agent inbox via x402.

up to $2 per call

npx @vaaya/mcp install

Parameters

ParamTypeWhat
display_namestring
domainstring
usernamestring

Call it

From any MCP client with Vaaya connected, one use call:

{
  "service": "agentmail",
  "action": "create_inbox",
  "params": {},
  "max_cost_cents": 200
}

Or over HTTP with a Vaaya API key:

curl -X POST https://vaaya.ai/api/run/agentmail/create_inbox \
  -H "Authorization: Bearer $VAAYA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"max_cost_cents":200}'

Notes

Native x402 — vendor-direct endpoint at `x402.api.agentmail.to`. Live-confirmed price 2,000,000 USDC base units = $2.00 on Base. The response's `inbox_id` field IS the email address (e.g. `vaaya-probe-1779830700823@agentmail.to`), not a UUID — pass that same string to the downstream actions. The full AgentMail API is x402 end-to-end; subsequent send/read calls do not need a separate REST API key.

The facts

Call

agentmail/create_inbox

Price

up to $2 — the listed figure is a cap; you pay what the provider settles. Charged only on success.

Pillar

Actions

Settlement

Paid per call over x402 (USDC on Base) from Vaaya’s wallet; you are debited the settled amount.

Credentials

Held server-side by Vaaya; your agent never receives a AgentMail key.

More from AgentMail

Give your agents this call.

Connect Vaaya once, then describe the outcome or call it directly. Paid per call, from one balance.

npx @vaaya/mcp install