Improve README for discoverability and developer conversion

- Renamed to 'AgentMail Python SDK' (clearer branding)
- Added compelling intro explaining two-way email vs send-only APIs
- Added 'What can you build?' section with 5 concrete use cases
- Added Related Packages table cross-linking toolkit, MCP, LangChain, Node SDK
- Added Links section to docs, API reference, examples
- Added MIT license badge
- Reordered badges (PyPI first for instant credibility)

Author: AgentMail Growth Bot

README.md

@@ -1,9 +1,20 @@
-# Agentmail Python Library
+# AgentMail Python SDK
 
-[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fagentmail-to%2Fagentmail-python)
 [![pypi](https://img.shields.io/pypi/v/agentmail)](https://pypi.python.org/pypi/agentmail)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+[![fern shield](https://img.shields.io/badge/%F0%9F%8C%BF-Built%20with%20Fern-brightgreen)](https://buildwithfern.com?utm_source=github&utm_medium=github&utm_campaign=readme&utm_source=https%3A%2F%2Fgithub.com%2Fagentmail-to%2Fagentmail-python)
+
+The official Python SDK for [AgentMail](https://agentmail.to) — the email inbox API built for AI agents.
+
+Unlike traditional email APIs (SendGrid, Resend, Amazon SES) that only handle sending, AgentMail provides **two-way email**: your agents get real inboxes that can send, receive, reply, and manage threaded conversations autonomously.
+
+### What can you build?
 
-The Agentmail Python library provides convenient access to the Agentmail APIs from Python.
+- **Customer support agents** that read incoming emails and draft contextual replies
+- **Sales outreach agents** that send personalized emails and handle responses
+- **Scheduling agents** that coordinate meetings through email threads
+- **Document processing agents** that receive, parse, and respond to email submissions
+- **Multi-agent workflows** where agents communicate with humans (and each other) via email
 
 ## Table of Contents
 
@@ -150,6 +161,22 @@ client = AgentMail(
 )
 ```
 
+## Related Packages
+
+| Package | Description |
+|---------|-------------|
+| [`agentmail-toolkit`](https://github.com/agentmail-to/agentmail-toolkit) | Agent framework integrations (OpenAI Agents SDK, Vercel AI SDK, MCP) |
+| [`agentmail-mcp`](https://www.npmjs.com/package/agentmail-mcp) | MCP server — give Claude, Cursor, or any MCP client email capabilities |
+| [`langchain-agentmail`](https://pypi.org/project/langchain-agentmail/) | LangChain tools integration |
+| [`agentmail` (npm)](https://www.npmjs.com/package/agentmail) | Node.js / TypeScript SDK |
+
+## Links
+
+- [Documentation](https://docs.agentmail.to)
+- [API Reference](https://docs.agentmail.to/api-reference)
+- [Examples](https://github.com/agentmail-to/agentmail-examples)
+- [AgentMail Website](https://agentmail.to)
+
 ## Contributing
 
 While we value open-source contributions to this SDK, this library is generated programmatically.