English Français العربية

smbCloud Mail & Auth

Official registry Productivity

Email infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http smbcloud-mail-auth 'https://api.smbcloud.xyz/v1/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "smbcloud-mail-auth": {
            "type": "http",
            "url": "https://api.smbcloud.xyz/v1/mcp"
        }
    }
}
NPM package @smbcloud/cli
Claude Code 
claude mcp add smbcloud-mail-auth -e 'SMB_MAIL_API_KEY=<your smb_mail_api_key>' -- npx -y @smbcloud/cli@0.7.5 --mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "smbcloud-mail-auth": {
            "command": "npx",
            "args": [
                "-y",
                "@smbcloud/cli@0.7.5",
                "--mcp"
            ],
            "env": {
                "SMB_MAIL_API_KEY": "<your smb_mail_api_key>"
            }
        }
    }
}

Environment variables

  • SMB_MAIL_API_KEY secret Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.
NUGET package SmbCloud.Cli
Claude Code 
claude mcp add smbcloud-mail-auth -e 'SMB_MAIL_API_KEY=<your smb_mail_api_key>' -- dnx SmbCloud.Cli@0.7.5 --yes --mcp
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "smbcloud-mail-auth": {
            "command": "dnx",
            "args": [
                "SmbCloud.Cli@0.7.5",
                "--yes",
                "--mcp"
            ],
            "env": {
                "SMB_MAIL_API_KEY": "<your smb_mail_api_key>"
            }
        }
    }
}

Environment variables

  • SMB_MAIL_API_KEY secret Mail app API key (smb_mail_...) used by the mail_send tool. Optional: every other tool uses the session from `smb login`.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. smbCloud CLI
  2. About
  3. Install
  4. Quick Start
  5. MCP server
  6. CI / non-interactive mode
  7. Documentation
  8. Contributing
  9. License
  10. Copyright

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

Apache-2.0

© 2026 Splitfire AB (smbCloud).

Frequently asked questions

What is smbCloud Mail & Auth?

Email infrastructure and authentication for developers: domains, inbox routes, auth apps, deploys.

How do I install smbCloud Mail & Auth?

It runs as a remote server. In Claude Code: claude mcp add --transport http smbcloud-mail-auth 'https://api.smbcloud.xyz/v1/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does smbCloud Mail & Auth need an API key?

Yes. It expects SMB_MAIL_API_KEY, which you set in its configuration.

Is smbCloud Mail & Auth open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains smbCloud Mail & Auth?

It is published by smbcloudXYZ. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.