Mailrith Agent Platform

This public repository contains the versioned developer surfaces for building safe AI agent email marketing workflows with Mailrith:

• The public API, OAuth, scope, risk, and MCP contract
• The official TypeScript and Python SDKs
• The local and self-hosted MCP server
• The Mailrith CLI
• The installable Mailrith Agent Skill and supported-client connection templates
• The installable ChatGPT/Codex, Claude Code, GitHub Copilot CLI, and Cursor plugin packages
• The Gemini CLI extension
• The Claude Connector listing, Microsoft certification package, Cline installation guide, and shared submission materials

The hosted Mailrith application and its private infrastructure remain in a separate private repository. This repository intentionally contains no application source, database migrations, deployment credentials, customer data, or private operational configuration.

Development

Requirements: Node.js 20 or newer, pnpm 11.7.0, and Python 3.10 or newer.

pnpm install --frozen-lockfile
pnpm validate

Generated SDK and MCP files come from packages/public-api. Change the public contract first, then run:

pnpm generate:agent-artifacts
pnpm generate:agent-integrations
pnpm agent:release:manifest

Commit the contract and every regenerated artifact in the same change.

Releases

The Release Agent Packages workflow prepares checksummed npm, Python, and platform packages on coordinated runs. The prepare-cli and cli targets prepare only the CLI archive. Publishing requires the protected agent-packages-production environment and trusted publishing configured for npm and PyPI. A matching agent-v<version> tag or an explicitly approved publish run starts publication.

The CLI, other npm packages, Python, and marketplace submission versions advance independently through the coordinated workflow. This keeps already-submitted marketplace archives unchanged while another package channel receives a compatible patch release. The release manifest records each version, the contract digest, package digests, and public-registry status.

The platform archives are submission-ready files for OpenAI, Claude, Cursor, Gemini CLI, GitHub Copilot CLI, Microsoft, and Cline. Provider review and public directory approval are separate from npm and PyPI publication.

CLI 1.1.2 was published to npm on September 4, 2026. The other packages and prepared marketplace artifacts remain at 1.1.1. See Releasing The CLI for the separate CLI version fields and the preparation and publication steps.

Security

Do not report security vulnerabilities in public issues. Follow SECURITY.md.

Official Builds And Forks

Forking the code is allowed. Modified public versions must use distinct names and clearly say that they are unofficial and not affiliated with Mailrith. See the Mailrith Trademark And Unofficial Fork Policy.

License

The code is available under the MIT License. Mailrith brand identifiers are not licensed with the code.