@sendora/mcp 1.5.2 → 1.8.6

package/LICENSE

@@ -19,3 +19,5 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+The MIT terms above do not cover the Sendora name or the Sendora symbol.

package/README.md

@@ -2,9 +2,11 @@
 
 The official [Model Context Protocol](https://modelcontextprotocol.io) server for
 [Sendora](https://sendora.se), transactional email delivery. It helps a coding
-agent such as Claude Code, Cursor or VS Code build against the API,
-`@sendora/sdk` for TypeScript or `sendora` for Python: it reads Sendora's documentation, sends a test mail and reads what
-happened to it, and sets up streams, webhooks and sending domains.
+agent such as Claude Code, Cursor or VS Code build against the API and its
+SDKs: `@sendora/sdk` for TypeScript, `sendora` for Python, and
+`sendora/sendora-php` for PHP with `sendora/sendora-laravel` for Laravel. It
+reads Sendora's documentation, sends a test mail and reads what happened to
+it, and sets up streams, webhooks and sending domains.
 
 The documentation is built into it: the guides, every operation of the API
 reference, the error codes and each SDK's README and rules for agents, from the
@@ -74,11 +76,19 @@ message's timeline, and `add_domain` and `check_domain` the domain's DNS
 records with a button that checks them again. Every other client gets the
 same answer as text.
 
-The documents are resources under `sendora://docs/…`, `sendora://reference/…`,
-`sendora://errors`, `sendora://sdk/readme`, `sendora://sdk/skill`,
-`sendora://sdk/python/readme` and `sendora://sdk/python/skill`, listed by
-`sendora://index`. Three prompts: `set_up_sendora`, `why_not_delivered` and
-`verify_webhooks`.
+The documents are resources, and `sendora://index` lists them:
+
+- the guides, under `sendora://docs/…`, and the API reference, under
+  `sendora://reference/…`;
+- the error codes, `sendora://errors`;
+- the TypeScript SDK's README and rules for agents, `sendora://sdk/readme`
+  and `sendora://sdk/skill`;
+- the Python SDK's, `sendora://sdk/python/readme` and
+  `sendora://sdk/python/skill`;
+- the PHP SDK's, `sendora://sdk/php/readme` and `sendora://sdk/php/skill`;
+- the Laravel package's README, `sendora://sdk/laravel/readme`.
+
+Three prompts: `set_up_sendora`, `why_not_delivered` and `verify_webhooks`.
 
 ## The official server
 

package/dist/docs.js

@@ -23,7 +23,11 @@ function indexOf(documents) {
         ].join('\n'),
     };
 }
-const SKILLS = new Set(['sendora://sdk/skill', 'sendora://sdk/python/skill']);
+const SKILLS = new Set([
+    'sendora://sdk/skill',
+    'sendora://sdk/python/skill',
+    'sendora://sdk/php/skill',
+]);
 /** The bundle as `scripts/build-docs.ts` writes it, checked, with the index in front. */
 export function docsFrom(bundle) {
     const built = bundleSchema.parse(bundle).documents;

package/dist/errors.js

@@ -5,6 +5,16 @@ const retryAfter = (error) => error.retryAfter === null
     ? 'Wait a moment and try again.'
     : `Wait ${String(error.retryAfter)} seconds and try again.`;
 const unconfirmed = () => 'Nothing was confirmed, so a send may or may not have been accepted: look for it with search_messages before sending again.';
+/** The limit on unpaid emails (docs/design/billing.md §3.5): a wait while a charge makes room, a send too large to ever fit, or a charge to pay first. */
+const unpaidLimit = (error) => {
+    if (error.retryAfter !== null) {
+        return `A charge for the emails so far is under way and makes room once it is paid. Wait ${String(error.retryAfter)} seconds and try again.`;
+    }
+    if (error.priceOre !== null && error.limitOre !== null && error.priceOre > error.limitOre) {
+        return "This send alone costs more than the account's limit for unpaid emails, so it never fits as one. Send it in smaller parts, or write to support@sendora.se to have the limit raised.";
+    }
+    return `No charge under way makes room yet. An administrator sees what the account owes under Account › Billing (Konto › Fakturering) in the dashboard, ${DASHBOARD}/account/billing.`;
+};
 const capOwner = {
     account: `An administrator raises the account's ceiling under Account › Usage (Konto › Användning) in the dashboard, ${DASHBOARD}/account/usage.`,
     server: "The server's own cap is Sendora's to set; write to support to change it.",
@@ -25,6 +35,7 @@ const hints = {
     read_only_connection: () => 'The person approved this connection without changes on live servers, and the account is read only through a connection. They can connect again and tick "Tillåt ändringar på liveservrar" on the approval page, or the change can be made on a test server.',
     test_server_only: () => 'Through a connected app, keys, webhooks and what cannot be undone happen on test servers only. Make the change on a test server, or in the dashboard.',
     payment_required: null,
+    unpaid_limit_reached: unpaidLimit,
     account_paused: null,
     account_not_active: null,
     spam_complaint_locked: null,