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.

Related MCP server: mailforce

Releases

The Release Agent Packages workflow prepares checksummed npm, Python, and platform packages on every manual run. 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 npm, 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.

Security

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

License

MIT