Welcome

Welcome to Loomal!

Give your AI agents a real identity — email, encrypted credentials, and 2FA. Everything an agent needs to operate in the real world.

Loomal is an identity platform for AI agents. Create an identity in the console, connect your agent via MCP or REST API, and your agent can send emails, store credentials, and generate TOTP codes — autonomously.

Get Started

Quickstart

Create your first identity and send an email in minutes.

MCP Setup

Connect your agent via Model Context Protocol — no packages needed.

API Reference

Explore the full REST API with real examples.

Concepts

Understand identities, scopes, threads, and the vault.

How It Works

Create an Identity

Go to console.loomal.ai and create an inbox identity. You get an email address (salesbot-x8k2m@mailgent.dev) and an API key (mgent-...).

Connect Your Agent

Add one MCP config or use the REST API — your agent gets 13 tools for email, vault, and TOTP.

{
  "mcpServers": {
    "loomal": {
      "url": "https://api.loomal.ai/mcp",
      "headers": { "LOOMAL_API_KEY": "mgent-your-api-key" }
    }
  }
}

Agent Operates

Your agent can now send/receive email, store credentials, and generate 2FA codes.

What Your Agent Gets

Mail

Tool	Description
`mail.whoami`	Get identity info
`mail.send`	Send email
`mail.reply`	Reply in thread
`mail.list_messages`	List inbox messages
`mail.get_message`	Read a message
`mail.update_labels`	Mark read/unread
`mail.list_threads`	List conversations
`mail.get_thread`	Get full conversation

Vault & TOTP

Tool	Description
`vault.list`	List stored credentials
`vault.get`	Get decrypted credential
`vault.store`	Store a credential
`vault.delete`	Delete a credential
`vault.totp`	Get 6-digit TOTP code

Identity Types

Type	Status	Channels
Inbox	Available	Email
Social	Coming soon	X, LinkedIn, Instagram
Voice	Coming soon	WhatsApp, Phone
Payment	Coming soon	Invoicing