🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP
Sign In

@mailrith/mcp-server

Package Overview
Dependencies
Maintainers
1
Versions
7
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

@mailrith/mcp-server - npm Package Compare versions

Comparing version
0.2.0
to
1.0.0
+14
dist/cli-options.d.ts
export type MailrithMcpCliOptions = {
transport: "stdio" | "http";
baseUrl?: string;
apiKey?: string;
host: string;
port: number;
};
type MailrithMcpCliEnvironment = {
MAILRITH_API_KEY?: string;
};
export declare const parseMailrithMcpCliOptions: (argv: string[], env?: MailrithMcpCliEnvironment) => MailrithMcpCliOptions;
export declare const requireMailrithMcpStdioCredential: (options: Pick<MailrithMcpCliOptions, "apiKey">) => void;
export {};
//# sourceMappingURL=cli-options.d.ts.map
{"version":3,"file":"cli-options.d.ts","sourceRoot":"","sources":["../src/cli-options.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,yBAAyB,GAAG;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B,CAAC;AASF,eAAO,MAAM,0BAA0B,GACrC,MAAM,MAAM,EAAE,EACd,MAAK,yBAAuC,KAC3C,qBAoDF,CAAC;AAEF,eAAO,MAAM,iCAAiC,GAC5C,SAAS,IAAI,CAAC,qBAAqB,EAAE,QAAQ,CAAC,SAO/C,CAAC"}
const resolveEnvironmentApiKey = (env) => {
const apiKey = env.MAILRITH_API_KEY?.trim();
return apiKey ? apiKey : undefined;
};
export const parseMailrithMcpCliOptions = (argv, env = process.env) => {
const environmentApiKey = resolveEnvironmentApiKey(env);
const options = {
transport: "stdio",
...(environmentApiKey ? { apiKey: environmentApiKey } : {}),
host: "127.0.0.1",
port: 8788,
};
for (let index = 0; index < argv.length; index += 1) {
const value = argv[index];
const nextValue = argv[index + 1];
if (!value?.startsWith("--")) {
continue;
}
if (value === "--transport" && nextValue) {
options.transport = nextValue === "http" ? "http" : "stdio";
index += 1;
continue;
}
if (value === "--base-url" && nextValue) {
options.baseUrl = nextValue;
index += 1;
continue;
}
if (value === "--api-key" && nextValue) {
const apiKey = nextValue.trim();
options.apiKey = apiKey ? apiKey : options.apiKey;
index += 1;
continue;
}
if (value === "--host" && nextValue) {
options.host = nextValue;
index += 1;
continue;
}
if (value === "--port" && nextValue) {
const parsed = Number(nextValue);
if (!Number.isNaN(parsed) && Number.isFinite(parsed)) {
options.port = parsed;
}
index += 1;
}
}
return options;
};
export const requireMailrithMcpStdioCredential = (options) => {
if (!options.apiKey) {
throw new Error("Local stdio requires a Mailrith credential. Set MAILRITH_API_KEY in the client secret environment or pass --api-key.");
}
};
//# sourceMappingURL=cli-options.js.map
{"version":3,"file":"cli-options.js","sourceRoot":"","sources":["../src/cli-options.ts"],"names":[],"mappings":"AAYA,MAAM,wBAAwB,GAAG,CAC/B,GAA8B,EAC9B,EAAE;IACF,MAAM,MAAM,GAAG,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IAC5C,OAAO,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CACxC,IAAc,EACd,MAAiC,OAAO,CAAC,GAAG,EACrB,EAAE;IACzB,MAAM,iBAAiB,GAAG,wBAAwB,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,OAAO,GAA0B;QACrC,SAAS,EAAE,OAAO;QAClB,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,IAAI;KACX,CAAC;IAEF,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAElC,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,aAAa,IAAI,SAAS,EAAE,CAAC;YACzC,OAAO,CAAC,SAAS,GAAG,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;YAC5D,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,YAAY,IAAI,SAAS,EAAE,CAAC;YACxC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;YAC5B,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,WAAW,IAAI,SAAS,EAAE,CAAC;YACvC,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;YAChC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;YAClD,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,IAAI,SAAS,EAAE,CAAC;YACpC,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC;YACzB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QAED,IAAI,KAAK,KAAK,QAAQ,IAAI,SAAS,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACrD,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC;YACxB,CAAC;YACD,KAAK,IAAI,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,OAA8C,EAC9C,EAAE;IACF,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CACb,sHAAsH,CACvH,CAAC;IACJ,CAAC;AACH,CAAC,CAAC"}
+13
-0

@@ -5,2 +5,8 @@ # Changelog

- Restore Full Email Marketing Access as the submitted OAuth bootstrap default
while keeping exact operation scopes on normal tools and exact call-time
authorization.
- Read `MAILRITH_API_KEY` in the local CLI and let the public API enforce
permissions for direct credential-backed runtimes that do not preload a
capability response.
- Route every permanent delete through `mailrith_delete`, including deletes that also require Perform Live Actions.

@@ -10,2 +16,9 @@ - Use effective workspace capabilities for connection, operation-search, and exact-schema availability instead of checking permissions alone.

## 1.0.0 - 2026-07-26
- Make the fixed submitted profile the default hosted and package surface, with focused tools, exact input and output schemas, human-readable titles, explicit annotations, and per-tool OAuth scopes.
- Allow anonymous static discovery for platform linking while rejecting every anonymous tool call before product access.
- Return tool-level OAuth challenges for missing connections and narrow grants, and keep scoped API-key support for direct and code-first clients.
- Preserve the compact seven-tool and configurable focused profiles as explicit compatibility options.
## 0.2.0 - 2026-07-24

@@ -12,0 +25,0 @@

+1
-1
#!/usr/bin/env node
export {};
export declare const runMailrithMcpCli: (argv?: string[]) => Promise<void>;
//# sourceMappingURL=cli.d.ts.map

@@ -1,1 +0,1 @@

{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}
{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAmHA,eAAO,MAAM,iBAAiB,GAC5B,OAAM,MAAM,EAA0B,kBAcvC,CAAC"}
#!/usr/bin/env node
import http from "node:http";
import { Readable } from "node:stream";
import { parseMailrithMcpCliOptions, requireMailrithMcpStdioCredential, } from "./cli-options.js";
import { handleMailrithMcpHttpRequest, runMailrithMcpStdioServer, } from "./index.js";
const parseCliOptions = (argv) => {
const options = {
transport: "stdio",
host: "127.0.0.1",
port: 8788,
};
for (let index = 0; index < argv.length; index += 1) {
const value = argv[index];
const nextValue = argv[index + 1];
if (!value?.startsWith("--")) {
continue;
}
if (value === "--transport" && nextValue) {
options.transport = nextValue === "http" ? "http" : "stdio";
index += 1;
continue;
}
if (value === "--base-url" && nextValue) {
options.baseUrl = nextValue;
index += 1;
continue;
}
if (value === "--api-key" && nextValue) {
options.apiKey = nextValue;
index += 1;
continue;
}
if (value === "--host" && nextValue) {
options.host = nextValue;
index += 1;
continue;
}
if (value === "--port" && nextValue) {
const parsed = Number(nextValue);
if (!Number.isNaN(parsed) && Number.isFinite(parsed)) {
options.port = parsed;
}
index += 1;
}
}
return options;
};
const hasRequestBody = (method) => method !== undefined && method !== "GET" && method !== "HEAD";

@@ -124,4 +83,4 @@ const toHeaders = (headers) => {

};
const main = async () => {
const options = parseCliOptions(process.argv.slice(2));
export const runMailrithMcpCli = async (argv = process.argv.slice(2)) => {
const options = parseMailrithMcpCliOptions(argv);
if (options.transport === "http") {

@@ -131,2 +90,3 @@ await startHttpServer(options);

}
requireMailrithMcpStdioCredential(options);
await runMailrithMcpStdioServer({

@@ -137,3 +97,3 @@ baseUrl: options.baseUrl,

};
await main();
await runMailrithMcpCli();
//# sourceMappingURL=cli.js.map

@@ -1,1 +0,1 @@

{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

@@ -1,1 +0,1 @@

{"version":3,"file":"generated-tool-manifest.d.ts","sourceRoot":"","sources":["../src/generated-tool-manifest.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,8BAA8B,GAAG,6BAA6B,GAAG,WAAW,GAAG,uBAAuB,GAAG,qBAAqB,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,sBAAsB,GAAG,0BAA0B,GAAG,mBAAmB,CAAC;AAEpQ,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,EAAE,SAAS;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;QAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,EAAE,CAAC;IACJ,KAAK,EAAE,SAAS;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,kBAAkB,EAAE,OAAO,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,SAAS,8BAA8B,EAAE,CAAC;QACpD,WAAW,EAAE;YACX,YAAY,EAAE,OAAO,CAAC;YACtB,eAAe,EAAE,OAAO,CAAC;YACzB,cAAc,EAAE,OAAO,CAAC;YACxB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,EAAE,CAAC;IACJ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,gCAAgu07B,CAAC"}
{"version":3,"file":"generated-tool-manifest.d.ts","sourceRoot":"","sources":["../src/generated-tool-manifest.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,8BAA8B,GAAG,6BAA6B,GAAG,WAAW,GAAG,uBAAuB,GAAG,qBAAqB,GAAG,YAAY,GAAG,WAAW,GAAG,aAAa,GAAG,sBAAsB,GAAG,0BAA0B,GAAG,mBAAmB,CAAC;AAEpQ,MAAM,MAAM,gCAAgC,GAAG;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,EAAE,SAAS;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;QAC7B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,EAAE,CAAC;IACJ,KAAK,EAAE,SAAS;QACd,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC;QACb,kBAAkB,EAAE,OAAO,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,QAAQ,EAAE,SAAS,8BAA8B,EAAE,CAAC;QACpD,WAAW,EAAE;YACX,YAAY,EAAE,OAAO,CAAC;YACtB,eAAe,EAAE,OAAO,CAAC;YACzB,cAAc,EAAE,OAAO,CAAC;YACxB,aAAa,EAAE,OAAO,CAAC;SACxB,CAAC;QACF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,EAAE,CAAC;IACJ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,eAAO,MAAM,gCAAgC,EAAE,gCAA6i47B,CAAC"}

@@ -6,3 +6,9 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";

import * as z from "zod/v4";
import { generatedMailrithMcpToolManifest } from "./generated-tool-manifest.js";
export { generatedMailrithMcpToolManifest };
export declare const mailrithMcpMaxAnonymousBatchItems = 1;
export declare const mailrithMcpMaxAuthenticatedBatchItems = 25;
type MailrithFetch = typeof fetch;
export declare const mailrithMcpProfileKeys: readonly ["submitted", "compact", "custom"];
export type MailrithMcpProfile = (typeof mailrithMcpProfileKeys)[number];
export type MailrithMcpServerOptions = {

@@ -18,2 +24,8 @@ baseUrl?: string;

capabilityContext?: MailrithMcpCapabilityContext;
/**
* `submitted` is the fixed public catalog used by listed platforms.
* `compact` preserves the legacy seven routing tools.
* `custom` exposes generated focused tools with caller-configured filters.
*/
profile?: MailrithMcpProfile;
};

@@ -38,2 +50,3 @@ export type MailrithMcpCapabilityLimitation = {

name: string;
title: string;
operation: MailrithSdkOperationDescriptor;

@@ -51,2 +64,8 @@ description: string;

};
securitySchemes: readonly [
{
type: "oauth2";
scopes: readonly string[];
}
];
meta: Record<string, unknown>;

@@ -60,2 +79,3 @@ invoke: (args?: Record<string, unknown>) => Promise<{

isError?: boolean;
_meta?: Record<string, unknown>;
}>;

@@ -83,4 +103,18 @@ };

};
export declare const mailrithSubmittedMcpToolNames: ("discovery_get_metadata" | "discovery_get_capabilities" | "discovery_get_open_api_document" | "workspace_get" | "sender_identities_list" | "sender_identities_get" | "email_delivery_connections_list" | "email_delivery_connections_start_setup" | "email_delivery_connections_get_setup" | "email_delivery_connections_renew_setup" | "email_delivery_connections_get" | "email_delivery_connections_update" | "email_delivery_connections_update_status" | "email_delivery_connections_verify" | "email_delivery_connections_send_test" | "email_delivery_connections_delete" | "analytics_create_report" | "analytics_get_report" | "diagnostics_list_automation_runs" | "diagnostics_get_automation_run" | "diagnostics_get_sequence" | "diagnostics_get_broadcast" | "diagnostics_get_subscriber" | "subscribers_list" | "subscribers_get" | "subscribers_upsert" | "subscribers_update" | "subscribers_delete" | "subscribers_update_status" | "subscribers_add_tag" | "subscribers_remove_tag" | "subscribers_add_to_sequence" | "subscribers_remove_from_sequence" | "tags_list" | "tags_create" | "tags_get" | "tags_update" | "tags_delete" | "custom_fields_list" | "custom_fields_create" | "custom_fields_get" | "custom_fields_update" | "custom_fields_delete" | "email_templates_list" | "email_templates_create" | "email_templates_get" | "email_templates_preview" | "email_templates_update" | "email_templates_delete" | "starting_points_list_email_templates" | "starting_points_get_email_template" | "starting_points_list_forms" | "starting_points_get_form" | "starting_points_list_landing_pages" | "starting_points_get_landing_page" | "forms_list" | "forms_create" | "forms_get" | "forms_list_submissions" | "forms_get_submission" | "forms_preview_double_opt_in" | "forms_update" | "forms_delete" | "landing_pages_list" | "landing_pages_create" | "landing_pages_get" | "landing_pages_list_submissions" | "landing_pages_get_submission" | "landing_pages_preview_double_opt_in" | "landing_pages_update" | "landing_pages_delete" | "sequences_list" | "sequences_create" | "sequences_get" | "sequences_preflight" | "sequences_preview_journey" | "sequences_send_test" | "sequences_update" | "sequences_update_status" | "sequences_delete" | "automations_list" | "automations_create" | "automations_get" | "automations_preflight" | "automations_preview_journey" | "automations_send_test" | "automations_update" | "automations_update_status" | "automations_delete" | "magic_links_list" | "magic_links_create" | "magic_links_get" | "magic_links_update" | "magic_links_delete" | "broadcasts_list" | "broadcasts_create" | "broadcasts_get_send_progress" | "broadcasts_list_delivery_errors" | "broadcasts_get" | "broadcasts_update" | "broadcasts_delete" | "broadcasts_preflight" | "broadcasts_schedule" | "broadcasts_unschedule" | "broadcasts_send" | "broadcasts_cancel" | "broadcasts_send_test" | "segments_list" | "segments_create" | "segments_get" | "segments_update" | "segments_delete" | "segments_preview" | "webhook_subscriptions_list" | "webhook_subscriptions_create" | "webhook_subscriptions_get" | "webhook_subscriptions_update" | "webhook_subscriptions_delete" | "webhook_subscriptions_rotate_secret" | "jobs_start_import_upload" | "jobs_get_import_upload" | "jobs_list_imports" | "jobs_create_import" | "jobs_get_import" | "jobs_list_exports" | "jobs_create_export" | "jobs_get_export")[];
export declare const mailrithSubmittedMcpOperationOAuthScopes: ("analytics:read" | "live_actions:write" | "subscribers:read" | "subscribers:write" | "subscribers:import" | "subscribers:export" | "segments:read" | "segments:write" | "tags:read" | "tags:write" | "forms:read" | "forms:write" | "form_submissions:read" | "landing_pages:read" | "landing_pages:write" | "landing_page_submissions:read" | "broadcasts:read" | "broadcasts:write" | "sequences:read" | "sequences:write" | "magic_links:read" | "magic_links:write" | "automations:read" | "automations:write" | "workspace:read" | "email_delivery_connections:read" | "email_delivery_connections:write" | "email_templates:read" | "email_templates:write" | "custom_fields:read" | "custom_fields:write" | "webhooks:read" | "webhooks:write")[];
/**
* The capability tool is the submitted profile's OAuth bootstrap. Requesting
* the complete public scope catalog lets Mailrith present every Work Profile
* and default a general-purpose connection to Full Email Marketing Access.
* Consent still grants only the profile or custom permissions the user
* approves, and every other submitted tool advertises its exact operation
* scopes for focused linking and step-up authorization.
*/
export declare const mailrithSubmittedMcpOAuthScopes: ("analytics:read" | "live_actions:write" | "subscribers:read" | "subscribers:write" | "subscribers:import" | "subscribers:export" | "segments:read" | "segments:write" | "tags:read" | "tags:write" | "forms:read" | "forms:write" | "form_submissions:read" | "landing_pages:read" | "landing_pages:write" | "landing_page_submissions:read" | "broadcasts:read" | "broadcasts:write" | "sequences:read" | "sequences:write" | "magic_links:read" | "magic_links:write" | "automations:read" | "automations:write" | "workspace:read" | "email_delivery_connections:read" | "email_delivery_connections:write" | "email_templates:read" | "email_templates:write" | "custom_fields:read" | "custom_fields:write" | "webhooks:read" | "webhooks:write")[];
export declare const parseMailrithMcpCapabilityContext: (value: unknown) => MailrithMcpCapabilityContext | null;
export declare const createMailrithMcpToolDefinitions: (client: MailrithClient, options?: Pick<MailrithMcpServerOptions, "grantedScopes" | "enabledToolsets" | "readOnly">) => MailrithMcpToolDefinition[];
export declare const createMailrithMcpToolDefinitions: (client: MailrithClient, options?: Pick<MailrithMcpServerOptions, "grantedScopes" | "enabledToolsets" | "readOnly" | "capabilityContext" | "baseUrl" | "apiKey"> & {
profile?: "submitted" | "custom";
enforceRuntimeAuthorization?: boolean;
}) => MailrithMcpToolDefinition[];
type MailrithCompactToolDefinition = {

@@ -110,3 +144,2 @@ name: string;

export declare const handleMailrithMcpHttpRequest: (request: Request, options?: MailrithMcpServerOptions) => Promise<Response>;
export {};
//# sourceMappingURL=index.d.ts.map

@@ -1,1 +0,1 @@

{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
{
"name": "@mailrith/mcp-server",
"version": "0.2.0",
"version": "1.0.0",
"description": "Official local and self-hosted MCP server for Mailrith.",

@@ -42,4 +42,4 @@ "license": "MIT",

"zod": "^4.1.12",
"@mailrith/public-api": "^0.2.0",
"@mailrith/sdk": "^0.2.0"
"@mailrith/sdk": "^1.0.0",
"@mailrith/public-api": "^1.0.0"
},

@@ -46,0 +46,0 @@ "devDependencies": {

+55
-30

@@ -17,4 +17,8 @@ # Mailrith MCP Server

selected workspace, but not billing, team, account-security,
credential-reading, or internal administration. A client can deliberately
select a focused Work Profile or read-only mode for a narrower connection.
credential-reading, or internal administration. The
`discovery_get_capabilities` connection check requests the complete public
permission catalog so Mailrith can show every Work Profile and default to Full
Email Marketing Access. The user can choose Reporting, another focused Work
Profile, or custom permissions instead. OAuth stores only the permissions the
user approves, and every tool checks those permissions again when it runs.

@@ -25,34 +29,55 @@ ```bash

The server exposes seven stable tools:
Local stdio and self-hosted HTTP use `MAILRITH_API_KEY` automatically. An
explicit `--api-key` value takes precedence. Keep either value in the client
secret store or process environment; never put it in a committed configuration
file. Local stdio stops with a clear setup error when neither value is present
because it has no browser-based OAuth flow.
- `mailrith_check_connection`
- `mailrith_search_operations`
- `mailrith_get_operation`
- `mailrith_read`
- `mailrith_write`
- `mailrith_delete`
- `mailrith_live`
The default `submitted` profile exposes a fixed reviewed catalog of focused
tools such as:
Search first, load one exact operation schema, then use the matching execution
tool. This keeps the initial agent context small while every operation remains
validated against the generated public contract. Search understands common
product wording, singular and plural resource names, and normal action words.
When several operations are equally plausible, the result is marked as
ambiguous so the agent can narrow the request before it executes anything.
- `subscribers_list`
- `broadcasts_create`
- `broadcasts_preflight`
- `broadcasts_schedule`
- `broadcasts_send`
- `sequences_update_status`
- `automations_update_status`
Availability is based on the authenticated workspace's effective capability
response, not permissions alone. Search, exact schema lookup, and connection
diagnosis report when the current plan, workspace limit, email delivery
connection, active toolset, read-only setting, or rollout state prevents an
otherwise permitted operation. Operations outside the active Work Profile or a
read-only connection remain searchable so an agent can explain the missing
access, but execution stays blocked. Actionable setup links are returned when
the capability response provides one.
Every submitted tool has a human-readable title, a narrow description, exact
input and output schemas, explicit safety annotations, and machine-readable
operation permissions. Tools other than the connection check advertise their
exact OAuth permissions. The connection check advertises the complete
permission catalog so OAuth can offer every Work Profile; its result still
reports the exact permissions granted to the connection. The catalog stays the
same for every user so clients can review and select tools reliably. Workspace
role, plan, product readiness, and granted permissions are enforced when a tool
runs.
`mailrith_get_operation` returns the exact input schema by default. Set
`include_output_schema` to `true` for the one operation whose result contract
the agent needs; this avoids loading every output schema into context.
Anonymous clients may initialize and list this static catalog so ChatGPT and
other hosts can start OAuth linking. Anonymous tool calls never reach the
Mailrith product API and return HTTP `401` with a standards-based
`WWW-Authenticate` challenge instead. Authenticated calls that need more
permissions return HTTP `403` with the complete replacement permission set.
Single-tool responses also include MCP's tool-level OAuth challenge metadata
for clients that use it when linking or reconnecting an account.
Each anonymous HTTP request accepts one JSON-RPC message. Authenticated
requests may batch up to 25 messages. These limits keep discovery and tool
responses predictable for every connected workspace.
Permanent deletion always uses `mailrith_delete`. A delete may still require
Perform Live Actions access when it removes a public or externally connected
resource; the operation schema lists every required permission.
Automation reads never return saved webhook bearer tokens or custom header
values. They return only whether each value is configured. If a client reads
an Automation and sends the redacted definition back during an update,
Mailrith preserves the existing values unless the client explicitly replaces
or removes them. Changing the webhook destination requires new credential
values so an old secret cannot be carried to another service.
The package also preserves two explicit compatibility profiles:
- `compact` exposes the earlier seven discovery and routing tools.
- `custom` exposes generated focused tools with caller-selected Work Profile,
permission, and read-only filters.
Use these profiles only for local or purpose-built clients. Public ChatGPT,
Codex, Claude, and Cursor packages use the fixed `submitted` profile at the
single `/mcp` endpoint.

Sorry, the diff of this file is too big to display

Sorry, the diff of this file is too big to display

Sorry, the diff of this file is too big to display

Sorry, the diff of this file is too big to display