@sendora/mcp 1.0.0 → 1.1.1

package/dist/instructions.js

@@ -4,6 +4,7 @@ import { LIVE_NOTE, SIMULATOR_NOTE, WRITES_OFF_NOTE } from './tools/server.js';
 const ABOUT = "Sendora is a transactional email service: an HTTP API, SMTP submission, the TypeScript SDK @sendora/sdk, signed webhooks and a message log with every delivery event. This server carries Sendora's documentation, and with a key, tools for that key's server or account.";
 const DOCS = `Before writing code against @sendora/sdk or the HTTP API, find the answer with search_docs and read the document with read_doc; ${INDEX_URI} lists them all, and sendora://sdk/skill holds the rules an agent must keep with the SDK.`;
 const KEYS = 'Never print or repeat a Sendora key, and never write one into a file under version control; keys belong in the environment.';
+const LIVE_DASHBOARD = `A person makes and revokes this server's keys, and makes and deletes its webhooks, in the dashboard, ${KEYS_PAGE}, with changes on or off, since a new key or signing secret must not reach this conversation.`;
 const ACCOUNT_DASHBOARD = `A server and a key are made in the dashboard, ${KEYS_PAGE}, since a new key is a secret this conversation must not see; a live server is deleted there too.`;
 function serverName(connection) {
     return connection.server === undefined
@@ -29,7 +30,7 @@ export function instructionsFor(connection) {
         case 'live':
             return [
                 ABOUT,
-                `This connection holds a key of ${serverName(connection)}. Call get_server first. ${LIVE_NOTE} ${connection.writes ? 'Changes are on for this connection: confirm with the user before anything reaches a real person.' : WRITES_OFF_NOTE}`,
+                `This connection holds a key of ${serverName(connection)}. Call get_server first. ${LIVE_NOTE} ${connection.writes ? 'Changes are on for this connection: confirm with the user before anything reaches a real person.' : WRITES_OFF_NOTE} ${LIVE_DASHBOARD}`,
                 DOCS,
                 KEYS,
             ].join('\n\n');

package/dist/listing.js

@@ -31,8 +31,11 @@ export function allowed(toolClass, kind, writes) {
             return kind === 'test' || (kind === 'account' && writes);
     }
 }
+/** Whether a connection of this kind, with changes on or off, lists the tool. */
+export function listedFor(tool, kind, writes) {
+    return reaches(tool.reach, kind) && allowed(tool.class, kind, writes);
+}
 /** Whether the connection lists the tool; a tool it does not list is not registered at all. */
 export function listed(tool, connection) {
-    const writes = connection.kind === 'none' ? false : connection.writes;
-    return reaches(tool.reach, connection.kind) && allowed(tool.class, connection.kind, writes);
+    return listedFor(tool, connection.kind, connection.kind !== 'none' && connection.writes);
 }

package/dist/tools/broadcasts.js

@@ -63,6 +63,7 @@ export function broadcastRequestOf(input) {
 /** `send_broadcast` (docs/design/mcp.md §4.2): a broadcast of at most 100 messages, on a test server. */
 export const sendBroadcastTool = {
     name: 'send_broadcast',
+    title: 'Send a test broadcast',
     class: 'irreversible',
     reach: 'server',
     operations: ['POST /v1/broadcasts'],
@@ -96,6 +97,7 @@ const broadcastIdInput = z.object({
 /** `get_broadcast` (docs/design/mcp.md §4.2): a broadcast and how far it has come. */
 export const getBroadcastTool = {
     name: 'get_broadcast',
+    title: 'Read a broadcast',
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/broadcasts/{id}'],
@@ -121,6 +123,7 @@ export const getBroadcastTool = {
 /** `cancel_broadcast` (docs/design/mcp.md §4.2): what has not left, stopped, on a test server. */
 export const cancelBroadcastTool = {
     name: 'cancel_broadcast',
+    title: 'Cancel a broadcast',
     class: 'irreversible',
     reach: 'server',
     operations: ['POST /v1/broadcasts/{id}/cancel'],

package/dist/tools/docs.js

@@ -11,6 +11,7 @@ const hitSchema = z.object({
 export const docsTools = [
     {
         name: 'search_docs',
+        title: 'Search the Sendora docs',
         class: 'docs',
         reach: 'all',
         operations: [],
@@ -45,6 +46,7 @@ export const docsTools = [
     },
     {
         name: 'read_doc',
+        title: 'Read a Sendora document',
         class: 'docs',
         reach: 'all',
         operations: [],

package/dist/tools/domains.js

@@ -46,6 +46,7 @@ export const checkedDomainOutput = domainOutput.extend({
 /** `list_domains` (docs/design/mcp.md §4.2): the account's sending domains and their records. */
 export const listDomainsTool = {
     name: 'list_domains',
+    title: 'List the sending domains',
     class: 'read',
     reach: 'account',
     operations: ['GET /v1/domains'],
@@ -73,6 +74,7 @@ export const listDomainsTool = {
 /** `check_domain` (docs/design/mcp.md §4.2): the records looked up now, which changes only what Sendora knows of them. */
 export const checkDomainTool = {
     name: 'check_domain',
+    title: 'Check a sending domain',
     class: 'read',
     reach: 'account',
     operations: ['POST /v1/domains/{id}/verify'],
@@ -100,6 +102,7 @@ export const checkDomainTool = {
 /** `add_domain` (docs/design/mcp.md §4.2): a sending domain added with its DKIM key, and the records to publish. */
 export const addDomainTool = {
     name: 'add_domain',
+    title: 'Add a sending domain',
     class: 'write',
     reach: 'account',
     operations: ['POST /v1/domains'],

package/dist/tools/inbound-domains.js

@@ -30,6 +30,7 @@ export const checkedInboundDomainOutput = inboundDomainOutput.extend({
 /** `list_inbound_domains` (docs/design/mcp.md §4.2): the live server's domains for receiving and their records. */
 export const listInboundDomainsTool = {
     name: 'list_inbound_domains',
+    title: 'List the domains for receiving',
     class: 'read',
     reach: 'live',
     operations: ['GET /v1/inbound/domains'],
@@ -57,6 +58,7 @@ export const listInboundDomainsTool = {
 /** `check_inbound_domain` (docs/design/mcp.md §4.2): the records looked up now, which changes only what Sendora knows of them. */
 export const checkInboundDomainTool = {
     name: 'check_inbound_domain',
+    title: 'Check a domain for receiving',
     class: 'read',
     reach: 'live',
     operations: ['POST /v1/inbound/domains/{id}/verify'],
@@ -84,6 +86,7 @@ export const checkInboundDomainTool = {
 /** `add_inbound_domain` (docs/design/mcp.md §4.2): a domain claimed for an inbound stream, and the records to add. */
 export const addInboundDomainTool = {
     name: 'add_inbound_domain',
+    title: 'Add a domain for receiving',
     class: 'write',
     reach: 'live',
     operations: ['POST /v1/inbound/domains'],

package/dist/tools/inbound.js

@@ -202,6 +202,7 @@ export const searchInboundInput = z.object({
 /** `search_inbound` (docs/design/mcp.md §5): received mail without anything its sender wrote but the From address. */
 export const searchInboundTool = {
     name: 'search_inbound',
+    title: 'Search received mail',
     class: 'read',
     reach: 'live',
     operations: ['POST /v1/inbound/search'],
@@ -234,6 +235,7 @@ export const searchInboundTool = {
 /** `read_inbound_message` (docs/design/mcp.md §5): one received message, what its sender wrote inside the fence. */
 export const readInboundMessageTool = {
     name: 'read_inbound_message',
+    title: 'Read a received message',
     class: 'read',
     reach: 'live',
     operations: ['GET /v1/inbound/{id}'],

package/dist/tools/keys.js

@@ -22,6 +22,7 @@ export const createdKeyOutput = keyOutput.extend({
 /** `list_keys` (docs/design/mcp.md §4.2, §3.4): the server's keys, the connection's own marked. */
 export const listKeysTool = {
     name: 'list_keys',
+    title: "List the server's keys",
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/tokens'],
@@ -53,6 +54,7 @@ export const listKeysTool = {
 /** `create_key` (docs/design/mcp.md §4.2): a key for a test server, answered once. */
 export const createKeyTool = {
     name: 'create_key',
+    title: 'Create a key',
     class: 'secret',
     reach: 'server',
     operations: ['POST /v1/tokens'],
@@ -98,6 +100,7 @@ function refusedOwnKey() {
 /** `revoke_key` (docs/design/mcp.md §4.2, §3.4): a test server's key revoked, never the connection's own. */
 export const revokeKeyTool = {
     name: 'revoke_key',
+    title: 'Revoke a key',
     class: 'irreversible',
     reach: 'server',
     operations: ['GET /v1/tokens', 'DELETE /v1/tokens/{id}'],

package/dist/tools/messages.js

@@ -88,6 +88,7 @@ export const searchInput = z.object({
 /** `search_messages` (docs/design/mcp.md §4.2): the server's log, filtered, newest first. */
 export const searchMessagesTool = {
     name: 'search_messages',
+    title: 'Search the message log',
     class: 'read',
     reach: 'server',
     operations: ['POST /v1/messages/search'],
@@ -119,6 +120,7 @@ export const searchMessagesTool = {
 /** `get_message` (docs/design/mcp.md §4.2): one message, its recipients, attachments described and timeline. */
 export const getMessageTool = {
     name: 'get_message',
+    title: 'Read one message and its timeline',
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/messages/{id}'],

package/dist/tools/send.js

@@ -98,6 +98,7 @@ const LIVE_DESCRIPTION = "Sends one email from this live server, to real people,
 /** `send_email` (docs/design/mcp.md §4.2): one message, and its outcome when it comes within the wait. */
 export const sendEmailTool = {
     name: 'send_email',
+    title: 'Send one email',
     class: 'write',
     reach: 'server',
     operations: ['POST /v1/email', 'GET /v1/messages/{id}'],

package/dist/tools/server.js

@@ -51,12 +51,22 @@ export const serverOutput = z.object({
         .describe('test for a server that delivers nothing, live for one that reaches real people.'),
     createdAt: z.string().describe('When it was created.'),
 });
+export const sendableDomainOutput = z.object({
+    domain: z.string().describe('The domain, as the part of a from address after the @.'),
+    failingSince: z
+        .string()
+        .nullable()
+        .describe('When a check first found one of its records missing; mail keeps going out for 24 hours from then. Null while every record is in place.'),
+});
 const outputSchema = z.object({
     server: serverOutput.describe('The server this key belongs to, and whether it is a test server.'),
     limits: z
         .array(limitOutput)
         .describe('Every limit a send on the server is held to, with its use this minute or month.'),
     streams: z.array(streamOutput).describe("The server's streams; a send names one as streamId."),
+    sendingDomains: z
+        .array(sendableDomainOutput)
+        .describe("The account's sending domains a from address may use now; a send from any other domain is refused with from_domain_not_verified."),
     connection: z
         .object({
         kind: z.enum(['test', 'live']).describe("The kind of this connection's key."),
@@ -77,12 +87,13 @@ export function serverConnectionOf(connection) {
 /** `get_server` (docs/design/mcp.md §4.2): where the agent stands before it acts. */
 export const getServerTool = {
     name: 'get_server',
+    title: 'Read the server this key belongs to',
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/server', 'GET /v1/streams'],
     register: (server, { connection }) => server.registerTool('get_server', {
         title: 'Read the server this key belongs to',
-        description: "Call this first. Answers the Sendora server this connection's key belongs to: whether it is a test server, where nothing is delivered, or a live one; every limit a send on it is held to, with this minute's and month's use; its streams; and whether this connection may change things.",
+        description: "Call this first. Answers the Sendora server this connection's key belongs to: whether it is a test server, where nothing is delivered, or a live one; every limit a send on it is held to, with this minute's and month's use; its streams; the domains a from address may use; and whether this connection may change things.",
         inputSchema: z.object({}),
         outputSchema,
         annotations: READING,
@@ -103,6 +114,7 @@ export const getServerTool = {
                 },
                 limits: own.limits,
                 streams,
+                sendingDomains: own.sendingDomains,
                 connection: { kind: own.mode, changes },
                 notes: own.mode === 'test'
                     ? [SIMULATOR_NOTE]

package/dist/tools/servers.js

@@ -12,6 +12,7 @@ export function accountConnectionOf(connection) {
 /** `list_servers` (docs/design/mcp.md §4.2): the account's servers, each with its mode. */
 export const listServersTool = {
     name: 'list_servers',
+    title: "List the account's servers",
     class: 'read',
     reach: 'account',
     operations: ['GET /v1/servers'],
@@ -51,6 +52,7 @@ function refusedLiveServer() {
  */
 export const deleteTestServerTool = {
     name: 'delete_test_server',
+    title: 'Delete a test server',
     class: 'irreversible',
     reach: 'account',
     operations: ['GET /v1/servers/{id}', 'DELETE /v1/servers/{id}'],

package/dist/tools/streams.js

@@ -4,6 +4,7 @@ import { serverConnectionOf, streamOutput } from './server.js';
 /** `create_stream` (docs/design/mcp.md §4.2): transactional or broadcast, and inbound only on a live server. */
 export const createStreamTool = {
     name: 'create_stream',
+    title: 'Add a stream',
     class: 'write',
     reach: 'server',
     operations: ['POST /v1/streams'],
@@ -50,6 +51,7 @@ export const createStreamTool = {
 /** `archive_stream` (docs/design/mcp.md §4.2): a test server's stream archived, for good. */
 export const archiveStreamTool = {
     name: 'archive_stream',
+    title: 'Archive a stream',
     class: 'irreversible',
     reach: 'server',
     operations: ['POST /v1/streams/{id}/archive'],

package/dist/tools/suppressions.js

@@ -22,6 +22,7 @@ const STREAM = 'The stream whose list is meant, from get_server; the default tra
 /** `list_suppressions` (docs/design/mcp.md §4.2): a stream's suppression list, per stream. */
 export const listSuppressionsTool = {
     name: 'list_suppressions',
+    title: "List a stream's suppression list",
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/suppressions'],
@@ -64,6 +65,7 @@ const REMOVE_DESCRIPTION = "Lifts an address from one stream's suppression list
 /** `remove_suppression` (docs/design/mcp.md §4.2): a hard bounce or a manual entry lifted. */
 export const removeSuppressionTool = {
     name: 'remove_suppression',
+    title: 'Lift a suppression',
     class: 'write',
     reach: 'server',
     operations: ['POST /v1/suppressions/delete'],

package/dist/tools/webhooks.js

@@ -84,6 +84,7 @@ export const createWebhookInput = z.object({
 /** `list_webhooks` (docs/design/mcp.md §4.2): the server's webhooks, their secrets by id and age alone. */
 export const listWebhooksTool = {
     name: 'list_webhooks',
+    title: "List the server's webhooks",
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/webhooks'],
@@ -111,6 +112,7 @@ export const listWebhooksTool = {
 /** `list_webhook_deliveries` (docs/design/mcp.md §4.2): one webhook's deliveries, by status. */
 export const listWebhookDeliveriesTool = {
     name: 'list_webhook_deliveries',
+    title: "List a webhook's deliveries",
     class: 'read',
     reach: 'server',
     operations: ['GET /v1/webhooks/{id}/deliveries'],
@@ -156,12 +158,13 @@ export const listWebhookDeliveriesTool = {
 /** `replay_webhook_delivery` (docs/design/mcp.md §4.2): an event queued for its webhook again. */
 export const replayWebhookDeliveryTool = {
     name: 'replay_webhook_delivery',
+    title: 'Replay a webhook delivery',
     class: 'write',
     reach: 'server',
     operations: ['POST /v1/webhooks/{id}/deliveries/{deliveryId}/replay'],
     register: (server, { connection }) => server.registerTool('replay_webhook_delivery', {
         title: 'Replay a webhook delivery',
-        description: 'Queues one delivery of a webhook again, whatever its state, with the same payload, a fresh signature and a fresh count of attempts: for an endpoint that was down or was fixed. Each replay posts the event once more.',
+        description: 'Queues one delivery of a webhook again, whatever its state, with the same payload and a fresh signature: for an endpoint that was down or was fixed. Its count of attempts carries on, so a delivery that had used every retry is dead again after one more failure. Each replay posts the event once more.',
         inputSchema: z.object({
             webhookId,
             deliveryId: z.uuid().describe('The delivery, from list_webhook_deliveries.'),
@@ -189,6 +192,7 @@ export const replayWebhookDeliveryTool = {
 /** `create_webhook` (docs/design/mcp.md §4.2): a webhook on a test server, its secret answered once. */
 export const createWebhookTool = {
     name: 'create_webhook',
+    title: 'Add a webhook',
     class: 'secret',
     reach: 'server',
     operations: ['POST /v1/webhooks'],
@@ -219,6 +223,7 @@ export const createWebhookTool = {
 /** `delete_webhook` (docs/design/mcp.md §4.2): a test server's webhook removed, for good. */
 export const deleteWebhookTool = {
     name: 'delete_webhook',
+    title: 'Delete a webhook',
     class: 'irreversible',
     reach: 'server',
     operations: ['DELETE /v1/webhooks/{id}'],

package/dist/version.js

@@ -1,2 +1,2 @@
 /** This package's version, held equal to its package.json by a test. */
-export const MCP_VERSION = '1.0.0';
+export const MCP_VERSION = '1.1.1';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sendora/mcp",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "The official MCP server for Sendora: its documentation and API for coding agents.",
   "license": "MIT",
   "type": "module",
@@ -25,7 +25,7 @@
   "dependencies": {
     "@modelcontextprotocol/server": "^2.1.0",
     "zod": "^4.6.2",
-    "@sendora/sdk": "^3.6.1"
+    "@sendora/sdk": "^3.7.0"
   },
   "devDependencies": {
     "@anthropic-ai/mcpb": "2.1.2",
@@ -38,12 +38,13 @@
     "typescript": "~7.0.2",
     "vitest": "^4.1.11",
     "@sendora/db": "0.0.0",
-    "@sendora/api": "0.0.0",
     "@sendora/domain": "0.0.0",
     "@sendora/observability": "0.0.0",
-    "@sendora/site": "0.0.0"
+    "@sendora/site": "0.0.0",
+    "@sendora/api": "0.0.0"
   },
   "scripts": {
-    "build": "pnpm --filter @sendora/sdk build && node scripts/build-docs.ts && node -e \"fs.rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json && node -e \"fs.mkdirSync('dist/generated',{recursive:true});fs.copyFileSync('src/generated/docs.json','dist/generated/docs.json')\""
+    "build": "pnpm --filter @sendora/sdk build && node scripts/build-docs.ts && node -e \"fs.rmSync('dist',{recursive:true,force:true})\" && tsc -p tsconfig.build.json && node -e \"fs.mkdirSync('dist/generated',{recursive:true});fs.copyFileSync('src/generated/docs.json','dist/generated/docs.json')\"",
+    "eval": "node eval/run.ts"
   }
 }