{"id":50456155,"url":"https://github.com/sendmux/sendmux-sdk","last_synced_at":"2026-07-02T07:01:06.504Z","repository":{"id":361361383,"uuid":"1253958043","full_name":"Sendmux/sendmux-sdk","owner":"Sendmux","description":"Official monorepo of SDKs, CLI, and MCP servers for Sendmux email APIs across TypeScript, Python, Go, PHP, Rust, and Ruby.","archived":false,"fork":false,"pushed_at":"2026-06-30T01:55:28.000Z","size":2546,"stargazers_count":109,"open_issues_count":15,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-30T03:17:52.070Z","etag":null,"topics":["cli","cli-tool","email","email-automation","email-marketing","inbox","inbox-automation","mcp","mcp-server","mcp-tools","sdk","sdk-go","sdk-php","sdk-python","sdk-typescript"],"latest_commit_sha":null,"homepage":"https://sendmux.ai/docs/sdks","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Sendmux.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-30T01:33:39.000Z","updated_at":"2026-06-30T01:29:11.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Sendmux/sendmux-sdk","commit_stats":null,"previous_names":["sendmux/sendmux-sdk"],"tags_count":50,"template":false,"template_full_name":null,"purl":"pkg:github/Sendmux/sendmux-sdk","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sendmux%2Fsendmux-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sendmux%2Fsendmux-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sendmux%2Fsendmux-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sendmux%2Fsendmux-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Sendmux","download_url":"https://codeload.github.com/Sendmux/sendmux-sdk/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Sendmux%2Fsendmux-sdk/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35036553,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-02T02:00:06.368Z","response_time":173,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cli-tool","email","email-automation","email-marketing","inbox","inbox-automation","mcp","mcp-server","mcp-tools","sdk","sdk-go","sdk-php","sdk-python","sdk-typescript"],"created_at":"2026-06-01T03:00:16.901Z","updated_at":"2026-07-02T07:01:06.493Z","avatar_url":"https://github.com/Sendmux.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sendmux SDKs\n\n[![npm version](https://img.shields.io/npm/v/@sendmux/sdk?label=npm)](https://www.npmjs.com/package/@sendmux/sdk)\n[![PyPI version](https://img.shields.io/pypi/v/sendmux-sdk?label=pypi)](https://pypi.org/project/sendmux-sdk/)\n[![Go Reference](https://pkg.go.dev/badge/sendmux.ai/go.svg)](https://pkg.go.dev/sendmux.ai/go)\n[![crates.io version](https://img.shields.io/crates/v/sendmux?label=crates.io)](https://crates.io/crates/sendmux)\n[![CI](https://github.com/Sendmux/sendmux-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/Sendmux/sendmux-sdk/actions/workflows/ci.yml)\n[![npm downloads](https://img.shields.io/npm/dm/@sendmux/sdk?label=npm%20downloads)](https://www.npmjs.com/package/@sendmux/sdk)\n[![Licence: MIT](https://img.shields.io/badge/licence-MIT-blue.svg)](LICENSE)\n\nOfficial SDK, CLI, and MCP workspace for Sendmux.\n\n- Product documentation: [sendmux.ai/docs](https://sendmux.ai/docs)\n- Management API reference: [sendmux.ai/docs/api/introduction](https://sendmux.ai/docs/api/introduction)\n- Mailbox API reference: [sendmux.ai/docs/mailbox-api/introduction](https://sendmux.ai/docs/mailbox-api/introduction)\n- Sending API reference: [sendmux.ai/docs/sending-api/introduction](https://sendmux.ai/docs/sending-api/introduction)\n- MCP guide: [sendmux.ai/docs/guides/mcp](https://sendmux.ai/docs/guides/mcp)\n\n## Packages\n\n| Ecosystem | Package | Surface | API key or auth | Install | Source |\n| --- | --- | --- | --- | --- | --- |\n| npm | `@sendmux/core` | Shared TypeScript helpers | n/a | `npm install @sendmux/core` | [`packages/ts/core`](packages/ts/core) |\n| npm | `@sendmux/sending` | Sending API | `smx_mbx_*` or owner-approved `smx_agent_*` | `npm install @sendmux/sending` | [`packages/ts/sending`](packages/ts/sending) |\n| npm | `@sendmux/mailbox` | Mailbox API | `smx_mbx_*` or `smx_agent_*` | `npm install @sendmux/mailbox` | [`packages/ts/mailbox`](packages/ts/mailbox) |\n| npm | `@sendmux/management` | Management API | `smx_root_*` | `npm install @sendmux/management` | [`packages/ts/management`](packages/ts/management) |\n| npm | `@sendmux/sdk` | TypeScript umbrella package | surface-specific | `npm install @sendmux/sdk` | [`packages/ts/sdk`](packages/ts/sdk) |\n| npm | `@sendmux/cli` | `sendmux` CLI | command/profile-specific | `npm install -g @sendmux/cli` | [`packages/ts/cli`](packages/ts/cli) |\n| Homebrew | `sendmux` | `sendmux` CLI | command/profile-specific | `brew install sendmux/tap/sendmux` | [`Sendmux/homebrew-tap`](https://github.com/Sendmux/homebrew-tap) |\n| PyPI | `sendmux-core` | Shared Python helpers | n/a | `pip install sendmux-core` | [`packages/python/core`](packages/python/core) |\n| PyPI | `sendmux-sending` | Sending API | `smx_mbx_*` or owner-approved `smx_agent_*` | `pip install sendmux-sending` | [`packages/python/sending`](packages/python/sending) |\n| PyPI | `sendmux-mailbox` | Mailbox API | `smx_mbx_*` or `smx_agent_*` | `pip install sendmux-mailbox` | [`packages/python/mailbox`](packages/python/mailbox) |\n| PyPI | `sendmux-management` | Management API | `smx_root_*` | `pip install sendmux-management` | [`packages/python/management`](packages/python/management) |\n| PyPI | `sendmux-sdk` | Python umbrella package | surface-specific | `pip install sendmux-sdk` | [`packages/python/sdk`](packages/python/sdk) |\n| 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`](packages/python/mcp) |\n| Go | `sendmux.ai/go/core` | Shared Go helpers | n/a | `go get sendmux.ai/go@v1.0.0` | [`go/core`](go/core) |\n| Go | `sendmux.ai/go/sending` | Sending API | `smx_mbx_*` or owner-approved `smx_agent_*` | `go get sendmux.ai/go@v1.0.0` | [`go/sending`](go/sending) |\n| Go | `sendmux.ai/go/mailbox` | Mailbox API | `smx_mbx_*` or `smx_agent_*` | `go get sendmux.ai/go@v1.0.0` | [`go/mailbox`](go/mailbox) |\n| Go | `sendmux.ai/go/management` | Management API | `smx_root_*` | `go get sendmux.ai/go@v1.0.0` | [`go/management`](go/management) |\n| Go | `sendmux.ai/go/sdk` | Go umbrella package | surface-specific | `go get sendmux.ai/go@v1.0.0` | [`go/sdk`](go/sdk) |\n| crates.io | `sendmux` | Rust umbrella crate | surface-specific | `cargo add sendmux` | [`rust`](rust) |\n| Packagist | `sendmux/core` | Shared PHP helpers | n/a | `composer require sendmux/core:^1.0` | [`packages/php/core`](packages/php/core) |\n| Packagist | `sendmux/sending` | Sending API | `smx_mbx_*` or owner-approved `smx_agent_*` | `composer require sendmux/sending:^1.0` | [`packages/php/sending`](packages/php/sending) |\n| Packagist | `sendmux/mailbox` | Mailbox API | `smx_mbx_*` or `smx_agent_*` | `composer require sendmux/mailbox:^1.0` | [`packages/php/mailbox`](packages/php/mailbox) |\n| Packagist | `sendmux/management` | Management API | `smx_root_*` | `composer require sendmux/management:^1.0` | [`packages/php/management`](packages/php/management) |\n| Packagist | `sendmux/sdk` | PHP umbrella package | surface-specific | `composer require sendmux/sdk:^1.0` | [`packages/php/sdk`](packages/php/sdk) |\n| RubyGems | `sendmux-core` | Shared Ruby helpers | n/a | `gem install sendmux-core` | [`packages/ruby/core`](packages/ruby/core) |\n| RubyGems | `sendmux-sending` | Sending API | `smx_mbx_*` or owner-approved `smx_agent_*` | `gem install sendmux-sending` | [`packages/ruby/sending`](packages/ruby/sending) |\n| RubyGems | `sendmux-mailbox` | Mailbox API | `smx_mbx_*` or `smx_agent_*` | `gem install sendmux-mailbox` | [`packages/ruby/mailbox`](packages/ruby/mailbox) |\n| RubyGems | `sendmux-management` | Management API | `smx_root_*` | `gem install sendmux-management` | [`packages/ruby/management`](packages/ruby/management) |\n| RubyGems | `sendmux-sdk` | Ruby umbrella package | surface-specific | `gem install sendmux-sdk` | [`packages/ruby/sdk`](packages/ruby/sdk) |\n\n## Quick start\n\nInstall only the package for the surface you need.\n\n```sh\nnpm install @sendmux/sending\npip install sendmux-sending\ngo get sendmux.ai/go@v1.0.0\ncargo add sendmux\ncomposer require sendmux/sending:^1.0\ngem install sendmux-sending\n```\n\nUse send-capable `smx_mbx_*` keys or owner-approved Sending-resource `smx_agent_*` tokens for Sending clients. Use `smx_mbx_*` keys or scoped `smx_agent_*` tokens for Mailbox clients. Use root `smx_root_*` keys for Management clients. Agent tokens remain limited by server-side scopes; pre-claim self-registered agent tokens do not include `email.send`.\n\nFor command-line access, install the CLI:\n\n```sh\nbrew install sendmux/tap/sendmux\nnpm install -g @sendmux/cli\nsendmux --help\n```\n\nFor MCP clients, install `sendmux-mcp` or connect to the hosted MCP endpoint:\n\n```sh\npip install sendmux-mcp\nsendmux-mcp-mailbox --help\n```\n\nThe hosted MCP endpoint is `https://mcp.sendmux.ai/mcp`. Local MCP commands support stdio and HTTP transports; hosted MCP uses OAuth and does not require manual API keys or custom OAuth endpoints.\n\n## Repository structure\n\n| Path | Purpose |\n| --- | --- |\n| [`packages/ts`](packages/ts) | TypeScript SDK packages and the `sendmux` CLI. |\n| [`packages/python`](packages/python) | Python SDK packages and the `sendmux-mcp` package. |\n| [`go`](go) | Go module `sendmux.ai/go` and subpackages. |\n| [`rust`](rust) | Rust crate published as `sendmux` on crates.io. |\n| [`packages/php`](packages/php) | PHP package sources used for Packagist packages and public split repositories. |\n| [`packages/ruby`](packages/ruby) | RubyGem package sources. |\n| [`codegen`](codegen) | Generator configuration and templates. |\n| [`scripts`](scripts) | Generation, verification, publishing, and release helper scripts. |\n| [`docs`](docs) | Surface-coverage and live E2E audit artefacts. |\n| [`.github/workflows`](.github/workflows) | CI, canary, live E2E, and release workflows. |\n\n## Versioning and support\n\nSDK packages track the Sendmux public API contracts. Patch versions can differ between packages when a fix only affects one ecosystem or runtime.\n\nGenerated clients are built from committed OpenAPI snapshots. Any API contract change must update the snapshots and generated output in the same change.\n\nFor help, open a [GitHub issue](https://github.com/Sendmux/sendmux-sdk/issues) with the package name, version, command or import path, and the request ID from any API error response.\n\n## Contributing\n\nOpen pull requests against this repository. Keep generated output, source snapshots, and verification artefacts together in the same change.\n\nSecurity issues should be reported through [GitHub Security Advisories](https://github.com/Sendmux/sendmux-sdk/security/advisories).\n\n## Licence\n\nThis repository is available under the [MIT licence](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsendmux%2Fsendmux-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsendmux%2Fsendmux-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsendmux%2Fsendmux-sdk/lists"}