Email and identity for AI agents.

{
  "mcpServers": {
    "pylota-mail": {
      "url": "https://mail.example.com/mcp",
      "headers": {
        "Authorization": "Bearer ${PYLOTA_MAIL_KEY}"
      }
    }
  }
}

# give the bookings agent its own identity
pmail identities create --username bookings --display-name "Acme Car Hire"

# exact reference lookup, filtered by sender and attachment
pmail search "from:@brightwell.example ref:AB12CDE has:attachment" --identity bookings@acme.example.com

# ask a question and get an answer with cited message IDs
pmail ask "Did the insurer accept the Golf claim?" --identity compliance@acme.example.com

curl -X POST https://mail.example.com/v1/identities/idn_01J9Z3K8V4/messages \
  -H "Authorization: Bearer $PYLOTA_MAIL_KEY" \
  -H "Idempotency-Key: bk-2291-confirm" \
  -H "Content-Type: application/json" \
  -d '{"to":["renter@example.org"],"subject":"Your booking BK-2291","text":"Your car is ready at 9:00."}'

use pylota_mail::Client;

async fn confirm_booking(key: String) -> Result<(), pylota_mail::Error> {
    let client = pylota_mail::Client::new("https://mail.example.com", key);

    let sent = client
        .identity("idn_01J9Z3K8V4")
        .send()
        .to("renter@example.org")
        .subject("Your booking BK-2291")
        .text("Your car is ready at 9:00.")
        .idempotency_key("bk-2291-confirm")
        .await?;

    // a retry with the same key returns this same message
    println!("{} deduplicated={}", sent.id, sent.deduplicated);
    Ok(())
}