Email for LangGraph Agents: Send and Receive over MCP

# Keys are issued from the dashboard, not over REST - the issuance surface is
# deliberately not agent-callable, so a leaked key can never mint or revoke
# another. To get one: Dashboard → API keys → pick the mailbox + a role
# (read / read_write / management) + an optional expiry → copy the sm_live_…
# secret (it is shown ONCE). Then set it for your agent and pass it as the
# Bearer token on every REST + MCP call:
export SAIRAPH_MAIL_KEY="sm_live_…"

import os
import asyncio

from langchain_mcp_adapters.client import MultiServerMCPClient
from langgraph.prebuilt import create_react_agent

client = MultiServerMCPClient(
    {
        "sairaph_mail": {
            # langchain-mcp-adapters accepts "streamable_http"; LangChain 1.0
            # docs also accept "http" for the same transport.
            "transport": "streamable_http",
            "url": "https://mail.sairaph.com/mcp/v1/mcp",
            "headers": {
                "Authorization": f"Bearer {os.environ['SAIRAPH_MAIL_KEY']}",
            },
        }
    }
)

async def main() -> None:
    tools = await client.get_tools()  # mailbox send + read actions, as LC tools
    agent = create_react_agent("anthropic:claude-sonnet-4-6", tools)
    result = await agent.ainvoke(
        {"messages": "Email agent@acme.dev a verification code, then watch for the reply."}
    )
    print(result["messages"][-1].content)

asyncio.run(main())

curl https://mail.sairaph.com/api/v1/mailboxes/$MAILBOX_ID/outbound \
  -H "Authorization: Bearer $SAIRAPH_MAIL_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["agent@acme.dev"],
    "subject": "Your verification code",
    "body_text": "Reply with APPROVE to continue."
  }'

# Read inbound from cache, or live=true for an on-demand fetch.
curl "https://mail.sairaph.com/api/v1/mailboxes/$MAILBOX_ID/messages?direction=inbound&live=true" \
  -H "Authorization: Bearer $SAIRAPH_MAIL_KEY"