Sendmux SDKs

Name: sendmux-sdk
Author: Sendmux

Official SDK, CLI, and MCP workspace for Sendmux.

Product documentation: docs.sendmux.ai
Management API reference: docs.sendmux.ai/api/introduction
Mailbox API reference: docs.sendmux.ai/mailbox-api/introduction
Sending API reference: docs.sendmux.ai/sending-api/introduction
MCP guide: docs.sendmux.ai/guides/mcp

Packages

Ecosystem	Package	Surface	API key or auth	Install	Source
npm	`@sendmux/core`	Shared TypeScript helpers	n/a	`npm install @sendmux/core`	`packages/ts/core`
npm	`@sendmux/sending`	Sending API	`smx_mbx_*`	`npm install @sendmux/sending`	`packages/ts/sending`
npm	`@sendmux/mailbox`	Mailbox API	`smx_mbx_*`	`npm install @sendmux/mailbox`	`packages/ts/mailbox`
npm	`@sendmux/management`	Management API	`smx_root_*`	`npm install @sendmux/management`	`packages/ts/management`
npm	`@sendmux/sdk`	TypeScript umbrella package	surface-specific	`npm install @sendmux/sdk`	`packages/ts/sdk`
npm	`@sendmux/cli`	`sendmux` CLI	command/profile-specific	`npm install -g @sendmux/cli`	`packages/ts/cli`
PyPI	`sendmux-core`	Shared Python helpers	n/a	`pip install sendmux-core`	`packages/python/core`
PyPI	`sendmux-sending`	Sending API	`smx_mbx_*`	`pip install sendmux-sending`	`packages/python/sending`
PyPI	`sendmux-mailbox`	Mailbox API	`smx_mbx_*`	`pip install sendmux-mailbox`	`packages/python/mailbox`
PyPI	`sendmux-management`	Management API	`smx_root_*`	`pip install sendmux-management`	`packages/python/management`
PyPI	`sendmux-sdk`	Python umbrella package	surface-specific	`pip install sendmux-sdk`	`packages/python/sdk`
PyPI	`sendmux-mcp`	Local, self-hosted, and hosted MCP servers	OAuth for hosted; surface-specific keys for local	`pip install sendmux-mcp`	`packages/python/mcp`
Go	`sendmux.ai/go/core`	Shared Go helpers	n/a	`go get sendmux.ai/[email protected]`	`go/core`
Go	`sendmux.ai/go/sending`	Sending API	`smx_mbx_*`	`go get sendmux.ai/[email protected]`	`go/sending`
Go	`sendmux.ai/go/mailbox`	Mailbox API	`smx_mbx_*`	`go get sendmux.ai/[email protected]`	`go/mailbox`
Go	`sendmux.ai/go/management`	Management API	`smx_root_*`	`go get sendmux.ai/[email protected]`	`go/management`
Go	`sendmux.ai/go/sdk`	Go umbrella package	surface-specific	`go get sendmux.ai/[email protected]`	`go/sdk`
Packagist	`sendmux/core`	Shared PHP helpers	n/a	`composer require sendmux/core:^1.0`	`packages/php/core`
Packagist	`sendmux/sending`	Sending API	`smx_mbx_*`	`composer require sendmux/sending:^1.0`	`packages/php/sending`
Packagist	`sendmux/mailbox`	Mailbox API	`smx_mbx_*`	`composer require sendmux/mailbox:^1.0`	`packages/php/mailbox`
Packagist	`sendmux/management`	Management API	`smx_root_*`	`composer require sendmux/management:^1.0`	`packages/php/management`
Packagist	`sendmux/sdk`	PHP umbrella package	surface-specific	`composer require sendmux/sdk:^1.0`	`packages/php/sdk`
RubyGems	`sendmux-core`	Shared Ruby helpers	n/a	`gem install sendmux-core`	`packages/ruby/core`
RubyGems	`sendmux-sending`	Sending API	`smx_mbx_*`	`gem install sendmux-sending`	`packages/ruby/sending`
RubyGems	`sendmux-mailbox`	Mailbox API	`smx_mbx_*`	`gem install sendmux-mailbox`	`packages/ruby/mailbox`
RubyGems	`sendmux-management`	Management API	`smx_root_*`	`gem install sendmux-management`	`packages/ruby/management`
RubyGems	`sendmux-sdk`	Ruby umbrella package	surface-specific	`gem install sendmux-sdk`	`packages/ruby/sdk`

Quick start

Install only the package for the surface you need.

npm install @sendmux/sending
pip install sendmux-sending
go get sendmux.ai/[email protected]
composer require sendmux/sending:^1.0
gem install sendmux-sending

Use mailbox-scoped smx_mbx_* keys for Sending and Mailbox clients. Use root smx_root_* keys for Management clients.

For command-line access, install the CLI:

npm install -g @sendmux/cli
sendmux --help

For MCP clients, install sendmux-mcp or connect to the hosted MCP endpoint:

pip install sendmux-mcp
sendmux-mcp-mailbox --help

The hosted product MCP endpoint is https://mcp.sendmux.ai/mcp. Local MCP commands support stdio and HTTP transports; hosted MCP uses OAuth.

Repository structure

Path	Purpose
`packages/ts`	TypeScript SDK packages and the `sendmux` CLI.
`packages/python`	Python SDK packages and the `sendmux-mcp` package.
`go`	Go module `sendmux.ai/go` and subpackages.
`packages/php`	PHP package sources used for Packagist packages and public split repositories.
`packages/ruby`	RubyGem package sources.
`codegen`	Generator configuration and templates.
`scripts`	Generation, verification, publishing, and release helper scripts.
`docs`	Surface-coverage and live E2E audit artefacts.
`.github/workflows`	CI, canary, live E2E, and release workflows.

Versioning and support

SDK packages track the Sendmux public API contracts. Patch versions can differ between packages when a fix only affects one ecosystem or runtime.

Generated clients are built from committed OpenAPI snapshots. Any API contract change must update the snapshots and generated output in the same change.

For help, open a GitHub issue with the package name, version, command or import path, and the request ID from any API error response.

Contributing

Open pull requests against this repository. Keep generated output, source snapshots, and verification artefacts together in the same change.

Security issues should be reported through GitHub Security Advisories.

Licence

This repository is available under the MIT licence.