@mailkite/mcp 0.3.0 → 0.5.0

package/spec/schemas/decrypt-request.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "decrypt-request",
+  "title": "Decrypt request",
+  "description": "Inputs to decrypt — a local hybrid-envelope decryption, no API call.",
+  "type": "object",
+  "required": ["envelope", "privateKey"],
+  "additionalProperties": false,
+  "properties": {
+    "envelope": {
+      "type": "string",
+      "description": "The at-rest envelope JSON string ({v,keyAlg,fp,enc,iv,wrappedKey,ciphertext}) from MailKite."
+    },
+    "privateKey": {
+      "type": "string",
+      "description": "Your RSA private key in PKCS8/PEM form (-----BEGIN PRIVATE KEY-----) — the match to the public key the envelope was wrapped to."
+    }
+  }
+}

package/spec/schemas/encrypt-request.json

@@ -0,0 +1,19 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "encrypt-request",
+  "title": "Encrypt request",
+  "description": "Inputs to encrypt — a local hybrid-envelope encryption, no API call.",
+  "type": "object",
+  "required": ["plaintext", "publicKey"],
+  "additionalProperties": false,
+  "properties": {
+    "plaintext": {
+      "type": "string",
+      "description": "The UTF-8 string to encrypt (e.g. a message body you're about to store)."
+    },
+    "publicKey": {
+      "type": "string",
+      "description": "The recipient domain's RSA public key in SPKI/PEM form (-----BEGIN PUBLIC KEY-----), ≥2048-bit."
+    }
+  }
+}

package/spec/schemas/send-request.json

@@ -37,9 +37,9 @@
         "required": ["filename"],
         "properties": {
           "filename": { "type": "string" },
-          "url": { "type": "string" },
-          "content": { "type": "string" },
-          "contentType": { "type": "string" }
+          "url": { "type": "string", "description": "Fetch the file from this URL at send time and attach it. Any URL works; an uploadAttachment() URL is the secure, recommended choice. Prefer this over `content` for large files." },
+          "content": { "type": "string", "description": "Inline file bytes as base64. Simple for tiny files, but re-uploaded on every send — use `url` (see uploadAttachment) for anything large." },
+          "contentType": { "type": "string", "description": "MIME type; defaults to application/octet-stream." }
         }
       }
     }

package/spec/schemas/upload-attachment-request.json

@@ -0,0 +1,18 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "upload-attachment-request",
+  "title": "Upload attachment request body",
+  "type": "object",
+  "required": ["filename", "content"],
+  "additionalProperties": false,
+  "properties": {
+    "filename": { "type": "string", "description": "The file's name, e.g. \"invoice.pdf\". Shown to recipients on download." },
+    "content": { "type": "string", "description": "The file bytes, base64-encoded." },
+    "contentType": { "type": "string", "description": "MIME type, e.g. \"application/pdf\". Defaults to application/octet-stream." },
+    "retentionDays": {
+      "type": "integer",
+      "enum": [7, 30, 90, 365],
+      "description": "How long the file (and its signed URL) stays valid. One of 7, 30, 90, 365. Defaults to 7."
+    }
+  }
+}

package/spec/schemas/upload-attachment-response.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "upload-attachment-response",
+  "title": "Upload attachment response",
+  "type": "object",
+  "properties": {
+    "id": { "type": "string", "description": "Storage key for the uploaded file." },
+    "url": { "type": "string", "description": "Secure, time-limited URL. Pass it as an attachment's `url` in send(), or link it inline in your HTML." },
+    "filename": { "type": "string" },
+    "contentType": { "type": "string" },
+    "size": { "type": "integer", "description": "Stored size in bytes." },
+    "expiresAt": { "type": "string", "description": "ISO-8601 timestamp when the file and URL expire." }
+  }
+}