NornWeave Documentation
NornWeave Documentation
Welcome to the NornWeave documentation. Learn how to set up and use the Inbox-as-a-Service API for your AI agents.
Getting Started
Installation, configuration, and your first inbox
Understand NornWeave’s architecture and design
REST API and MCP integration documentation
Setup guides for Mailgun, SendGrid, SES, and more
Frequently asked questions about NornWeave
Architecture Overview
| Component | Name | Purpose |
|---|---|---|
| Storage Layer | Urdr (The Well) | Database adapters (PostgreSQL, SQLite) |
| Ingestion Engine | Verdandi (The Loom) | Webhook processing, HTML to Markdown |
| API & Outbound | Skuld (The Prophecy) | REST API, email sending, rate limiting |
| Gateway | Yggdrasil | API router connecting all providers |
| MCP Tools | Huginn & Muninn | Read/write tools for AI agents |
For detailed data flows and sequence diagrams, see Concepts → Architecture.
Supported Mail Providers
| Provider | Sending | Receiving | Auto-Route Setup |
|---|---|---|---|
| Mailgun | Yes | Yes (webhooks) | Yes |
| AWS SES | Yes | Yes (webhooks) | Manual |
| SendGrid | Yes | Yes (webhooks) | Yes |
| Resend | Yes | Yes (webhooks) | Yes |
| IMAP/SMTP | Yes (SMTP) | Yes (IMAP polling) | N/A |