smbCloud Mail & Auth
Email infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http smbcloud-mail-auth 'https://api.smbcloud.xyz/v1/mcp'
{
"mcpServers": {
"smbcloud-mail-auth": {
"type": "http",
"url": "https://api.smbcloud.xyz/v1/mcp"
}
}
}
@smbcloud/cliclaude mcp add smbcloud-mail-auth -e 'SMB_MAIL_API_KEY=<your smb_mail_api_key>' -- npx -y @smbcloud/cli@0.7.5 --mcp
{
"mcpServers": {
"smbcloud-mail-auth": {
"command": "npx",
"args": [
"-y",
"@smbcloud/cli@0.7.5",
"--mcp"
],
"env": {
"SMB_MAIL_API_KEY": "<your smb_mail_api_key>"
}
}
}
}
Variables d'environnement
SMB_MAIL_API_KEYsecret Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.
SmbCloud.Cliclaude mcp add smbcloud-mail-auth -e 'SMB_MAIL_API_KEY=<your smb_mail_api_key>' -- dnx SmbCloud.Cli@0.7.5 --yes --mcp
{
"mcpServers": {
"smbcloud-mail-auth": {
"command": "dnx",
"args": [
"SmbCloud.Cli@0.7.5",
"--yes",
"--mcp"
],
"env": {
"SMB_MAIL_API_KEY": "<your smb_mail_api_key>"
}
}
}
}
Variables d'environnement
SMB_MAIL_API_KEYsecret Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
smbCloud CLI
smbCloud Mail, Auth, Deploy, and GresIQ from your terminal or your AI agent.
Website · Documentation · Contributing · Releases
About
smb is the command-line interface for smbCloud. It is
also an MCP server, so Claude, Cursor, and other AI agents can run the same operations
you do.
Send transactional email and set up domains and inbox routing on smbCloud Mail, manage authentication apps on smbCloud Auth, and deploy Rust, Node.js, Ruby, or Swift apps. One binary, no runtime to install.
Install
If you want the quickest setup, use a pre-built native binary.
Homebrew (macOS & Linux)
brew tap smbcloudXYZ/tap && brew trust --tap smbcloudXYZ/tap
brew install cli
npm
npm install -g @smbcloud/cli
.NET tool
dotnet tool install --global SmbCloud.Cli
pip
pip install smbcloud-cli
Shell (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-unix.sh | sh
PowerShell (Windows)
irm https://raw.githubusercontent.com/smbcloudXYZ/smbcloud-cli/main/install-windows.sh | iex
Or grab a pre-built binary from the Releases page.
Quick Start
smb login
smb init
smb deploy
That gets you from login to first deploy.
MCP server
smb --mcp speaks the Model Context Protocol over
stdio, exposing 31 tools across smbCloud Mail, Auth, projects, and deployments. It is
listed in the official MCP Registry as io.github.smbcloudXYZ/smbcloud-cli.
Claude Code:
claude mcp add smbcloud -- smb --mcp
Claude Desktop, Cursor, and anything else that takes a JSON config:
{
"mcpServers": {
"smbcloud": {
"command": "npx",
"args": ["@smbcloud/cli", "--mcp"]
}
}
}
Auth comes from smb login, so a terminal session and an agent session share the same
token and the same selected project. See docs/mcp.md for the full tool
reference.
For mobile and TV app testing, run the focused XCRS Mobile & TV Automation profile:
claude mcp add xcrs -- smb --mcp --scope automation
It exposes target-aware Xcode, ControlKit, CoreDevice, and adb tools without
mixing them into the cloud tool set. The same profile is also available from
the standalone xcrs --mcp crate.
CI / non-interactive mode
Pass --ci (or set SMB_CI=1, or run under any provider that sets CI) to
disable interactive prompts. Confirmations take their default; anything that
truly needs input fails fast with a clear message instead of hanging on a
missing TTY.
smb --ci deploy
For example, the AircraftsHub monorepo deploys
its Next.js web app with a single non-interactive command — its
.smb/config.toml pins the project, source, and runtime, so smb --ci deploy
needs no prompts. See docs/ci.md for token setup and the full
behavior reference.
Documentation
See the docs/ directory for guides on authentication, project configuration, and deployment workflows.
Contributing
Read CONTRIBUTING.md to get started. Contributions are welcome.
For the broader product, see smbCloud and the deployment docs.
License
Copyright
© 2026 Splitfire AB (smbCloud).
Questions fréquentes
Qu'est-ce que smbCloud Mail & Auth ?
Email infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.
Comment installer smbCloud Mail & Auth ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http smbcloud-mail-auth 'https://api.smbcloud.xyz/v1/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour smbCloud Mail & Auth ?
Oui. Il attend SMB_MAIL_API_KEY, à renseigner dans sa configuration.
smbCloud Mail & Auth est-il open source ?
Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.
Qui maintient smbCloud Mail & Auth ?
Il est publié par smbcloudXYZ. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.