> ## Documentation Index
> Fetch the complete documentation index at: https://sendmux.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent frameworks

> Give an agent built on any major framework its own mailbox and sending access.

Use this section to wire Qubrics into an agent you are building in code. Every framework here reaches Qubrics through MCP, so the tools your agent gets are the tools your key or grant allows.

> [!NOTE]
>
> These pages cover frameworks you build agents with. To configure Qubrics in a
> coding assistant such as Claude Code or Cursor, use
> [MCP client setup](https://sendmux.ai/docs/ai-integrations/mcp/clients).

> [!WARNING]
>
> Replace placeholder keys and tokens before running any snippet. Do not commit
> `smx_root_`, `smx_mbx_`, or private HTTP bearer tokens to version control.

## Choose a connection

Framework agents run without a browser, so pick the connection your runtime can complete.

| Connection | Use it when | How the key travels |
| - | - | - |
| Local stdio | Your process can launch `sendmux-mcp` on the same machine. | Process environment |
| Private HTTP | Your agent runs elsewhere, or your framework only accepts a URL. | `Authorization` header |
| Hosted OAuth | Your framework can complete a browser MCP OAuth flow or hold an OAuth client provider. | Qubrics-issued token |

Local stdio is the shortest path for a single service. Private HTTP suits containers, serverless runtimes, and any framework whose MCP client sends headers but cannot spawn a process.

> [!NOTE]
>
> The local package installs from PyPI, so a stdio connection needs Python
> available in the same runtime. Choose private HTTP when your service runs
> somewhere that cannot install it.

## Pick your framework

> [card] [Mastra](https://sendmux.ai/docs/ai-integrations/frameworks/mastra.md)
>
> Connect with `@mastra/mcp` and hand the tools to an Agent.

> [card] [LangGraph](https://sendmux.ai/docs/ai-integrations/frameworks/langgraph.md)
>
> Load tools through the LangChain MCP adapters.

> [card] [CrewAI](https://sendmux.ai/docs/ai-integrations/frameworks/crewai.md)
>
> Attach tools to a crew with `MCPServerAdapter`.

> [card] [AI SDK](https://sendmux.ai/docs/ai-integrations/frameworks/ai-sdk.md)
>
> Use `createMCPClient` with `generateText` or `streamText`.

> [card] [OpenAI Agents SDK](https://sendmux.ai/docs/ai-integrations/frameworks/openai-agents-sdk.md)
>
> Pass a server into `mcp_servers` on an Agent.

> [card] [Google ADK](https://sendmux.ai/docs/ai-integrations/frameworks/google-adk.md)
>
> Add an `McpToolset` to an `LlmAgent`.

## What your agent can do

Tool names are generated from the current public API surfaces, so open your framework's tool listing after connecting to see what a given key or grant exposes.

| Surface | Typical agent work | Key |
| - | - | - |
| Mailbox | List, search, read, thread, label, and reply from granted mailboxes. | `smx_mbx_` or scoped `smx_agent_` |
| Sending | Send single or batch email. | Send-capable `smx_mbx_`, or owner-approved Sending-resource `smx_agent_` |
| Management | Provision mailboxes, domains, sending accounts, and webhooks. | `smx_root_` |

> [!WARNING]
>
> Give an agent the narrowest surface that completes its task. A mailbox-scoped
> key confines the agent to the mail you granted it. A `smx_root_` key does not.

## Sending stays gated

A durable `smx_agent_` token carries `mailbox.read` and `email.receive`, not `email.send`. A named human owner has to accept the invite and approve sending before the agent exchanges that token for a one-hour Sending-resource token. Build the approval step into your agent's flow rather than around it.

## Next steps

> [card] [MCP](https://sendmux.ai/docs/ai-integrations/mcp)
>
> Review connection modes, environment variables, and tool discovery.

> [card] [Agent access](https://sendmux.ai/docs/ai-integrations/agent-access.md)
>
> Register an agent and complete owner approval.

> [card] [Agent skills](https://sendmux.ai/docs/ai-integrations/agent-skills.md)
>
> Install the skills pack so agents reach for Qubrics by default.

> [card] [API keys](https://sendmux.ai/docs/account/api-keys.md)
>
> Create and scope the credentials your agent uses.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.