Identities for AI agents

Provision real email, phone, payment cards, bank accounts, addresses, credentials, and persistent memory in one API call. Your agents interact with the real world via REST API or native MCP. You stay in control.

api.mermaidagents.ai
POST /api/v1/avatars

{
  "name": "Shopping Agent",
  "region": "us",
  "assets": {
    "emails": 1,
    "phones": 1,
    "cards": 1,
    "addresses": 1
  }
}
202 Accepted·231ms
{
  "id": "avt_f7k2m9x",
  "name": "Shopping Agent",
  "status": "provisioning",
  "emails": [{ "address": "avt-f7k@agents.mermaidagents.ai" }],
  "phones": [{ "number": "+1-555-0142" }],
  "cards": [{ "last_four": "3847", "brand": "visa" }],
  "addresses": [{ "city": "Los Angeles", "state": "CA" }]
}

How it works

01

Create

One API call provisions a complete set of real-world assets for your agent, including Just-In-Time payment cards with $0 standing limits.

POST /api/v1/avatars
{ "name": "Shopping Agent", "assets": { "emails": 1, "cards": 1 } }
02

Use

Your agent uses real emails, phones, and cards to interact with services. Access everything via REST API or MCP tools. Retrieve stored credentials, persist context to memory, and read messages across sessions.

email = avatar.emails[0].address
creds = client.credentials.reveal(avatar.id, "api_key")
client.memory.put(avatar.id, "ctx", value, tags=["shopify"])
03

Control

Approve transactions, set spend limits, and auto-expire assets when done.

DELETE /api/v1/avatars/avt_f7k2m9x
# All assets deprovisioned instantly
avt-f7k@agents.agentagents.ai3 messages
noreply@acme.com
2m ago

Verify your email address

Click the link below to verify your email address...

orders@megastore.co
14m ago

Your order #4821 has shipped

Your package is on its way. Track it here...

hello@saasapp.io
1h ago

Welcome to your new account

Thanks for signing up. Here's how to get started...

Real email addresses. Real inboxes.

Each avatar gets a working email address. Receive verification codes, marketing emails, password resets. Read them via API or webhook.

  • Dedicated inbound email per avatar
  • Webhook notification on every received message
  • Full MIME access via API: headers, body, attachments
9:41+1-555-0142
Your verification code is 847291. Do not share this code.
Got it, code received. Entering now.
Your account has been verified successfully.
Message

Real phone numbers. SMS and voice.

Provision US phone numbers that receive SMS and voice calls. Handle 2FA verification, phone confirmations, and automated calls.

  • Real US phone numbers
  • SMS and voice capable
  • Webhook on every inbound message and call
Mermaid Agents

Shopping Agent

VIRTUAL
4242 ···· ···· 3847
Limit

$500/txn

Expires

12/26

VISA
Monthly spend$127.43 / $500.00

Just-In-Time payments.

Cards have a $0 limit by default. Your agent requests approval for exactly what it needs, you approve, and the limit resets to $0 right after the transaction.

  • $0 limit until you approve a specific purchase
  • Approve the exact amount, then it resets automatically
  • Real-time approval requests via API and webhooks
  • Unused approvals expire, so nothing lingers
Bank Account

$2,847.00

Available balance
Routing110000000
Account••••••4891
TypeChecking (ACH)
Recent
ACH credit from Acme Corp+$1,200.00
Wire to SaaS vendor-$349.00

Virtual bank accounts with real-time controls.

Real US financial accounts with routing and account numbers. Send and receive ACH transfers, wire payments, and track balances. Full control via API.

  • Real US bank accounts with routing numbers
  • ACH and wire transfer support
  • Real-time balance monitoring and transaction webhooks
  • Freeze, limit, or close accounts instantly via API
Verified
Home

Shopping Agent Alpha

1847 Westwood Blvd, Apt 12

Los Angeles, CA 90025

United States

Verified
Billing

Shopping Agent Alpha

350 Fifth Avenue, Suite 3100

New York, NY 10118

United States

Real physical addresses.

Give your agents verifiable mailing addresses for billing, shipping, and identity verification. Multiple addresses per avatar with home, work, and billing labels.

  • Verifiable US mailing addresses
  • Multiple per avatar: home, work, billing, shipping
  • Region-aware address generation
  • Manage via API or dashboard
Credential Vault
KMS Encrypted
OpenAI API Keysensitive
openai_api_key

sk-proj-••••••••••••••••

Reveal
Shopify Passwordsensitive
shopify_password

••••••••••••

Reveal
Wix OAuth Tokensensitive
wix_oauth_token

oauth_••••••••••••

Reveal
Stripe Publishable
stripe_pk

pk_live_51N...8xR

Reveal
4 credentialsEvery reveal audit-logged

Encrypted credential storage.

Store passwords, API keys, tokens, and secrets for your agents. Admins write credentials, agents retrieve them on-demand. Every reveal is audit-logged.

  • KMS-encrypted at rest, decrypted only on reveal
  • Admin-only write access -- agents can read, never create
  • Full audit trail on every credential access
  • Manage via REST API, MCP, or dashboard
Agent Memory12 / 200 entries
All (12)shopify (7)wix (5)
shopify_preferencesshopify

{"theme": "dawn", "currency": "USD", ...}

1.2 KB
wix_site_configwix

{"site_id": "abc123", "plan": "business"}

856 B
user_preferencesshopifywix

{"timezone": "America/New_York", ...}

340 B

Persistent memory across sessions.

Tagged key-value storage that lets agents remember context between runs. Agents tag entries by domain and selectively load only what they need. Context windows stay lean. Knowledge compounds.

  • Tag entries by domain, workflow, or any custom label
  • Filter by tag on read -- load only relevant context
  • 200 entries per agent, 10KB per entry
  • Upsert semantics with full CRUD via API and MCP

Native MCP server.

Connect Claude Desktop, Cursor, or any MCP-compatible client directly to your agents. Every capability exposed as a Model Context Protocol tool — no SDK required.

mermaid-agents
api.mermaidagents.ai/mcp
31 tools
Streamable HTTP

Messages

6
  • list_messages
  • get_message
  • send_email
  • send_sms
  • get_thread
  • mark_as_read

Memory

5
  • list_memory
  • get_memory
  • set_memory
  • delete_memory
  • list_memory_tags

Cards

5
  • list_cards
  • get_card
  • reveal_card_details
  • list_card_transactions
  • create_payment_token

Bank

3
  • list_bank_accounts
  • get_bank_account
  • list_bank_transactions

Credentials

3
  • list_credentials
  • get_credential
  • generate_credential

Avatars

2
  • list_avatars
  • get_avatar

Approvals

2
  • list_approvals
  • get_approval

Commerce

5
  • browse_merchant
  • start_purchase
  • pay_for_purchase
  • get_purchase_status
  • cancel_purchase
Integration guideRead the docs

Scoped API key authentication. Same permissions model as REST.

Built for developers

Clean, predictable APIs. Create, use, and clean up identities in a few lines of code.

import mermaid_agents

client = mermaid_agents.Client("ak_live_...")

# Provision an avatar with real-world assets
avatar = client.avatars.create(
    name="Shopping Agent",
    assets={"emails": 1, "phones": 1, "cards": 1}
)

# Use the provisioned identity
print(avatar.emails[0].address)  # avt-f7k@agents.mermaidagents.ai
print(avatar.cards[0].last_four)    # 3847

# Clean up when done
client.avatars.delete(avatar.id)

Simple, transparent pricing

Start free. Scale when you're ready.

Free

$0/mo

For exploring

  • 5 avatars
  • 1 asset each
  • Community support
  • API access
Start free
Most popular

Starter

$49/mo

For teams shipping agents

  • 100 avatars
  • 5 assets each
  • Email support
  • Webhooks
  • Dashboard
Get started

Pro

$199/mo

For production workloads

  • Unlimited avatars
  • 25 assets each
  • Priority support
  • Webhooks
  • Custom domains
Get started

All plans include: API access, webhooks, dashboard, and docs. Usage: $0.05/transaction. Volume discounts available.

Ready to give your agents a real-world identity?

Start free. No credit card required.