@signdocs-brasil/mcp-server 0.1.0

package/dist/schemas.d.ts

@@ -0,0 +1,179 @@
+import { z } from 'zod';
+export declare const createSigningSessionShape: {
+    purpose: z.ZodEnum<["DOCUMENT_SIGNATURE", "ACTION_AUTHENTICATION"]>;
+    policyProfile: z.ZodString;
+    customSteps: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    signer: z.ZodObject<{
+        name: z.ZodString;
+        userExternalId: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        cpf: z.ZodOptional<z.ZodString>;
+        cnpj: z.ZodOptional<z.ZodString>;
+        otpChannel: z.ZodOptional<z.ZodEnum<["email", "sms"]>>;
+        otpChannelSelectable: z.ZodOptional<z.ZodBoolean>;
+        birthDate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        userExternalId: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+        cpf?: string | undefined;
+        cnpj?: string | undefined;
+        otpChannel?: "email" | "sms" | undefined;
+        otpChannelSelectable?: boolean | undefined;
+        birthDate?: string | undefined;
+    }, {
+        name: string;
+        userExternalId: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+        cpf?: string | undefined;
+        cnpj?: string | undefined;
+        otpChannel?: "email" | "sms" | undefined;
+        otpChannelSelectable?: boolean | undefined;
+        birthDate?: string | undefined;
+    }>;
+    documentBase64: z.ZodOptional<z.ZodString>;
+    documentFilename: z.ZodOptional<z.ZodString>;
+    action: z.ZodOptional<z.ZodObject<{
+        type: z.ZodString;
+        description: z.ZodString;
+        reference: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        type: string;
+        reference?: string | undefined;
+    }, {
+        description: string;
+        type: string;
+        reference?: string | undefined;
+    }>>;
+    returnUrl: z.ZodOptional<z.ZodString>;
+    cancelUrl: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    locale: z.ZodOptional<z.ZodEnum<["pt-BR", "en", "es"]>>;
+    expiresInMinutes: z.ZodOptional<z.ZodNumber>;
+    owner: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        email?: string | undefined;
+        name?: string | undefined;
+    }, {
+        email?: string | undefined;
+        name?: string | undefined;
+    }>>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+};
+export declare const sessionIdShape: {
+    sessionId: z.ZodString;
+};
+export declare const listSigningSessionsShape: {
+    status: z.ZodString;
+    limit: z.ZodOptional<z.ZodNumber>;
+    cursor: z.ZodOptional<z.ZodString>;
+};
+export declare const resendOtpShape: {
+    sessionId: z.ZodString;
+    channel: z.ZodOptional<z.ZodEnum<["email", "sms"]>>;
+};
+export declare const createEnvelopeShape: {
+    signingMode: z.ZodEnum<["PARALLEL", "SEQUENTIAL"]>;
+    totalSigners: z.ZodNumber;
+    documentBase64: z.ZodString;
+    documentFilename: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    locale: z.ZodOptional<z.ZodEnum<["pt-BR", "en", "es"]>>;
+    returnUrl: z.ZodOptional<z.ZodString>;
+    cancelUrl: z.ZodOptional<z.ZodString>;
+    expiresInMinutes: z.ZodOptional<z.ZodNumber>;
+    owner: z.ZodOptional<z.ZodObject<{
+        name: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        email?: string | undefined;
+        name?: string | undefined;
+    }, {
+        email?: string | undefined;
+        name?: string | undefined;
+    }>>;
+    idempotencyKey: z.ZodOptional<z.ZodString>;
+};
+export declare const envelopeIdShape: {
+    envelopeId: z.ZodString;
+};
+export declare const addEnvelopeSessionShape: {
+    envelopeId: z.ZodString;
+    signer: z.ZodObject<{
+        name: z.ZodString;
+        userExternalId: z.ZodString;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        cpf: z.ZodOptional<z.ZodString>;
+        cnpj: z.ZodOptional<z.ZodString>;
+        otpChannel: z.ZodOptional<z.ZodEnum<["email", "sms"]>>;
+        otpChannelSelectable: z.ZodOptional<z.ZodBoolean>;
+        birthDate: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        userExternalId: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+        cpf?: string | undefined;
+        cnpj?: string | undefined;
+        otpChannel?: "email" | "sms" | undefined;
+        otpChannelSelectable?: boolean | undefined;
+        birthDate?: string | undefined;
+    }, {
+        name: string;
+        userExternalId: string;
+        email?: string | undefined;
+        phone?: string | undefined;
+        cpf?: string | undefined;
+        cnpj?: string | undefined;
+        otpChannel?: "email" | "sms" | undefined;
+        otpChannelSelectable?: boolean | undefined;
+        birthDate?: string | undefined;
+    }>;
+    policyProfile: z.ZodString;
+    purpose: z.ZodOptional<z.ZodEnum<["DOCUMENT_SIGNATURE", "ACTION_AUTHENTICATION"]>>;
+    signerIndex: z.ZodNumber;
+    returnUrl: z.ZodOptional<z.ZodString>;
+    cancelUrl: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+};
+export declare const uploadDocumentShape: {
+    transactionId: z.ZodString;
+    documentBase64: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+};
+export declare const transactionIdShape: {
+    transactionId: z.ZodString;
+};
+export declare const listTransactionsShape: {
+    status: z.ZodOptional<z.ZodString>;
+    userExternalId: z.ZodOptional<z.ZodString>;
+    documentGroupId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    nextToken: z.ZodOptional<z.ZodString>;
+    startDate: z.ZodOptional<z.ZodString>;
+    endDate: z.ZodOptional<z.ZodString>;
+};
+export declare const verifyEvidenceShape: {
+    evidenceId: z.ZodString;
+};
+export declare const verifyEnvelopeShape: {
+    envelopeId: z.ZodString;
+};
+export declare const verifyDocumentShape: {
+    documentBase64: z.ZodString;
+    filename: z.ZodOptional<z.ZodString>;
+};
+export declare const registerWebhookShape: {
+    url: z.ZodString;
+    events: z.ZodArray<z.ZodEnum<["TRANSACTION.CREATED", "TRANSACTION.COMPLETED", "TRANSACTION.CANCELLED", "TRANSACTION.FAILED", "TRANSACTION.EXPIRED", "STEP.STARTED", "STEP.COMPLETED", "STEP.FAILED", "QUOTA.WARNING", "API.DEPRECATION_NOTICE", "SIGNING_SESSION.CREATED", "SIGNING_SESSION.COMPLETED", "SIGNING_SESSION.CANCELLED", "SIGNING_SESSION.EXPIRED", "ENVELOPE.CREATED", "ENVELOPE.ALL_SIGNED", "ENVELOPE.EXPIRED"]>, "many">;
+};
+export declare const webhookIdShape: {
+    webhookId: z.ZodString;
+};

package/dist/schemas.js

@@ -0,0 +1,169 @@
+import { z } from 'zod';
+/**
+ * Zod input shapes for every MCP tool. Each export is a ZodRawShape (a plain
+ * object of Zod types) passed straight to `server.registerTool(...)`. They are
+ * a flattened, AI-friendly projection of the SDK request types — handlers in
+ * tools/*.ts assemble the nested SDK request objects from these.
+ */
+const PURPOSE = z
+    .enum(['DOCUMENT_SIGNATURE', 'ACTION_AUTHENTICATION'])
+    .describe('DOCUMENT_SIGNATURE to sign a PDF; ACTION_AUTHENTICATION to authenticate an action with no document.');
+const LOCALE = z.enum(['pt-BR', 'en', 'es']).describe('UI/email language. Default pt-BR.');
+const POLICY_PROFILE = z
+    .string()
+    .describe('Identity-assurance profile: CLICK_ONLY, CLICK_PLUS_OTP, BIOMETRIC, BIOMETRIC_PLUS_OTP, or CUSTOM. ' +
+    'Read the signdocs://policy-profiles resource for the authoritative list — an invalid value returns 400.');
+const signerObject = z
+    .object({
+    name: z.string().describe('Signer full name.'),
+    userExternalId: z.string().describe('Stable per-signer ID in your system (used for biometric enrollment lookup).'),
+    email: z.string().email().optional().describe('Required to email the signer their invite link.'),
+    phone: z.string().optional().describe('E.164 phone, e.g. +5541999998888 (for SMS OTP).'),
+    cpf: z.string().optional().describe('Brazilian individual taxpayer ID (digits only).'),
+    cnpj: z.string().optional().describe('Brazilian company taxpayer ID (digits only).'),
+    otpChannel: z.enum(['email', 'sms']).optional().describe('Preferred OTP delivery channel.'),
+    otpChannelSelectable: z.boolean().optional().describe('Let the signer pick the OTP channel.'),
+    birthDate: z.string().optional().describe('ISO date (YYYY-MM-DD), used by some gov-db validations.'),
+})
+    .describe('The person who will sign / authenticate.');
+const ownerObject = z
+    .object({
+    name: z.string().optional(),
+    email: z.string().email().optional(),
+})
+    .optional()
+    .describe('The requester (distinct from the signer). When set and signer.email differs, SignDocs auto-emails ' +
+    'the signer an invite and notifies the owner on completion. Omit to deliver links yourself via webhooks.');
+const metadata = z.record(z.string()).optional().describe('Free-form key/value tags (keys ≤256, values ≤1024 chars).');
+// ── Signing sessions ────────────────────────────────────────────────────────
+export const createSigningSessionShape = {
+    purpose: PURPOSE,
+    policyProfile: POLICY_PROFILE,
+    customSteps: z
+        .array(z.string())
+        .optional()
+        .describe('Ordered step types — REQUIRED only when policyProfile=CUSTOM (e.g. ["CLICKWRAP","OTP"]).'),
+    signer: signerObject,
+    documentBase64: z
+        .string()
+        .optional()
+        .describe('Base64-encoded PDF (≤10MB). Required when purpose=DOCUMENT_SIGNATURE.'),
+    documentFilename: z.string().optional().describe('Original filename, e.g. contrato.pdf.'),
+    action: z
+        .object({
+        type: z.string(),
+        description: z.string(),
+        reference: z.string().optional(),
+    })
+        .optional()
+        .describe('What is being authenticated — used when purpose=ACTION_AUTHENTICATION.'),
+    returnUrl: z.string().url().optional().describe('Redirect URL after completion (sessionId appended as query param).'),
+    cancelUrl: z.string().url().optional().describe('Redirect URL if the signer cancels.'),
+    metadata,
+    locale: LOCALE.optional(),
+    expiresInMinutes: z.number().int().min(5).max(1440).optional().describe('Session lifetime, 5–1440 min (default 60).'),
+    owner: ownerObject,
+    idempotencyKey: z.string().optional().describe('Idempotency key for safe retries; a UUID is generated if omitted.'),
+};
+export const sessionIdShape = {
+    sessionId: z.string().describe('The signing session ID (sigex_…).'),
+};
+export const listSigningSessionsShape = {
+    status: z
+        .string()
+        .describe('Filter by status: ACTIVE, COMPLETED, CANCELLED, EXPIRED, or FAILED.'),
+    limit: z.number().int().min(1).max(100).optional().describe('Page size (default server value).'),
+    cursor: z.string().optional().describe('Pagination cursor from a previous response (nextCursor).'),
+};
+export const resendOtpShape = {
+    sessionId: z.string().describe('The signing session ID.'),
+    channel: z.enum(['email', 'sms']).optional().describe('Override OTP delivery channel.'),
+};
+// ── Envelopes (multi-signer) ─────────────────────────────────────────────────
+export const createEnvelopeShape = {
+    signingMode: z.enum(['PARALLEL', 'SEQUENTIAL']).describe('PARALLEL: anyone signs in any order. SEQUENTIAL: ordered.'),
+    totalSigners: z.number().int().min(1).describe('How many signers will be added to this envelope.'),
+    documentBase64: z.string().describe('Base64-encoded PDF (≤10MB) shared by all signers.'),
+    documentFilename: z.string().optional(),
+    metadata,
+    locale: LOCALE.optional(),
+    returnUrl: z.string().url().optional(),
+    cancelUrl: z.string().url().optional(),
+    expiresInMinutes: z.number().int().optional(),
+    owner: ownerObject,
+    idempotencyKey: z.string().optional().describe('Idempotency key for safe retries; a UUID is generated if omitted.'),
+};
+export const envelopeIdShape = {
+    envelopeId: z.string().describe('The envelope ID (env_…).'),
+};
+export const addEnvelopeSessionShape = {
+    envelopeId: z.string().describe('The envelope to add a signer to.'),
+    signer: signerObject,
+    policyProfile: POLICY_PROFILE,
+    purpose: PURPOSE.optional(),
+    signerIndex: z.number().int().min(0).describe('Zero-based position of this signer (0..totalSigners-1).'),
+    returnUrl: z.string().url().optional(),
+    cancelUrl: z.string().url().optional(),
+    metadata,
+};
+// ── Documents ────────────────────────────────────────────────────────────────
+export const uploadDocumentShape = {
+    transactionId: z.string().describe('Transaction to attach the document to (txn_…).'),
+    documentBase64: z.string().describe('Base64-encoded PDF (≤10MB).'),
+    filename: z.string().optional(),
+};
+export const transactionIdShape = {
+    transactionId: z.string().describe('The transaction ID (txn_…).'),
+};
+// ── Transactions (low-level / search) ────────────────────────────────────────
+export const listTransactionsShape = {
+    status: z.string().optional().describe('Filter by transaction status (e.g. PENDING, COMPLETED, CANCELLED).'),
+    userExternalId: z.string().optional().describe('Filter by signer external ID.'),
+    documentGroupId: z.string().optional(),
+    limit: z.number().int().min(1).max(100).optional(),
+    nextToken: z.string().optional().describe('Pagination token from a previous response.'),
+    startDate: z.string().optional().describe('ISO date lower bound.'),
+    endDate: z.string().optional().describe('ISO date upper bound.'),
+};
+// ── Verification ─────────────────────────────────────────────────────────────
+export const verifyEvidenceShape = {
+    evidenceId: z.string().describe('Evidence ID (evd_…) to verify. Public — no signer PII is revealed.'),
+};
+export const verifyEnvelopeShape = {
+    envelopeId: z.string().describe('Envelope ID to verify all signers for. Public endpoint.'),
+};
+export const verifyDocumentShape = {
+    documentBase64: z.string().describe('Base64-encoded PDF to inspect for embedded signatures.'),
+    filename: z.string().optional(),
+};
+// ── Webhooks ─────────────────────────────────────────────────────────────────
+const WEBHOOK_EVENTS = [
+    'TRANSACTION.CREATED',
+    'TRANSACTION.COMPLETED',
+    'TRANSACTION.CANCELLED',
+    'TRANSACTION.FAILED',
+    'TRANSACTION.EXPIRED',
+    'STEP.STARTED',
+    'STEP.COMPLETED',
+    'STEP.FAILED',
+    'QUOTA.WARNING',
+    'API.DEPRECATION_NOTICE',
+    'SIGNING_SESSION.CREATED',
+    'SIGNING_SESSION.COMPLETED',
+    'SIGNING_SESSION.CANCELLED',
+    'SIGNING_SESSION.EXPIRED',
+    'ENVELOPE.CREATED',
+    'ENVELOPE.ALL_SIGNED',
+    'ENVELOPE.EXPIRED',
+];
+export const registerWebhookShape = {
+    url: z.string().url().describe('HTTPS endpoint that will receive event POSTs.'),
+    events: z
+        .array(z.enum(WEBHOOK_EVENTS))
+        .min(1)
+        .describe('Event types to subscribe to. The response returns a signing secret for HMAC verification.'),
+};
+export const webhookIdShape = {
+    webhookId: z.string().describe('The webhook ID to act on.'),
+};
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare const SERVER_NAME = "signdocs-brasil";
+export declare const SERVER_VERSION = "0.1.0";
+/**
+ * Build a fully-wired MCP server. Transport-agnostic: the same instance is
+ * mounted on stdio (bin/stdio.ts) today and on Streamable HTTP later
+ * (http/server.ts).
+ */
+export declare function createServer(): McpServer;

package/dist/server.js

@@ -0,0 +1,38 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerSigningSessionTools } from './tools/signingSessions.js';
+import { registerEnvelopeTools } from './tools/envelopes.js';
+import { registerDocumentTools } from './tools/documents.js';
+import { registerTransactionTools } from './tools/transactions.js';
+import { registerEvidenceTools } from './tools/evidence.js';
+import { registerVerifyTools } from './tools/verify.js';
+import { registerWebhookTools } from './tools/webhooks.js';
+import { registerResources } from './resources.js';
+export const SERVER_NAME = 'signdocs-brasil';
+export const SERVER_VERSION = '0.1.0';
+const INSTRUCTIONS = `SignDocs Brasil electronic-signature API.
+
+Use signing sessions for single-signer flows and envelopes for multi-signer
+documents. Read the signdocs://quickstart and signdocs://policy-profiles
+resources before creating sessions.
+
+Tools whose names start with create_, add_, cancel_, delete_, or verify_document
+take real, quota-consuming, and often legally-binding actions — confirm with the
+human before invoking them. All other tools are read-only or non-binding.`;
+/**
+ * Build a fully-wired MCP server. Transport-agnostic: the same instance is
+ * mounted on stdio (bin/stdio.ts) today and on Streamable HTTP later
+ * (http/server.ts).
+ */
+export function createServer() {
+    const server = new McpServer({ name: SERVER_NAME, version: SERVER_VERSION }, { instructions: INSTRUCTIONS });
+    registerSigningSessionTools(server);
+    registerEnvelopeTools(server);
+    registerDocumentTools(server);
+    registerTransactionTools(server);
+    registerEvidenceTools(server);
+    registerVerifyTools(server);
+    registerWebhookTools(server);
+    registerResources(server);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAC7C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,YAAY,GAAG;;;;;;;;0EAQqD,CAAC;AAE3E;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAC9C,EAAE,YAAY,EAAE,YAAY,EAAE,CAC/B,CAAC;IAEF,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACpC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,wBAAwB,CAAC,MAAM,CAAC,CAAC;IACjC,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC9B,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC5B,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC7B,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE1B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/documents.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDocumentTools(server: McpServer): void;

package/dist/tools/documents.js

@@ -0,0 +1,22 @@
+import { getClient } from '../client.js';
+import { READ_ONLY, WRITE_SAFE } from '../annotations.js';
+import { run } from './helpers.js';
+import { uploadDocumentShape, transactionIdShape } from '../schemas.js';
+export function registerDocumentTools(server) {
+    server.registerTool('upload_document', {
+        title: 'Upload document',
+        description: 'Upload a base64-encoded PDF to an existing transaction (≤10MB inline; use presign for larger).',
+        inputSchema: uploadDocumentShape,
+        annotations: WRITE_SAFE,
+    }, async (args) => run(() => getClient().documents.upload(args.transactionId, {
+        content: args.documentBase64,
+        ...(args.filename ? { filename: args.filename } : {}),
+    })));
+    server.registerTool('download_document', {
+        title: 'Download document',
+        description: 'Get presigned download URLs for a transaction’s document and signed artifacts.',
+        inputSchema: transactionIdShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().documents.download(args.transactionId)));
+}
+//# sourceMappingURL=documents.js.map

package/dist/tools/documents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"documents.js","sourceRoot":"","sources":["../../src/tools/documents.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,gGAAgG;QAC7G,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,UAAU;KACxB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,GAAG,CAAC,GAAG,EAAE,CACP,SAAS,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,EAAE;QAC/C,OAAO,EAAE,IAAI,CAAC,cAAc;QAC5B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtD,CAAC,CACH,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAC9E,CAAC;AACJ,CAAC"}

package/dist/tools/envelopes.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerEnvelopeTools(server: McpServer): void;

package/dist/tools/envelopes.js

@@ -0,0 +1,59 @@
+import { getClient, buildSigningUrl } from '../client.js';
+import { CONFIRM_WARNING, DESTRUCTIVE, READ_ONLY } from '../annotations.js';
+import { run, idempotencyKey } from './helpers.js';
+import { createEnvelopeShape, envelopeIdShape, addEnvelopeSessionShape } from '../schemas.js';
+export function registerEnvelopeTools(server) {
+    server.registerTool('create_envelope', {
+        title: 'Create envelope',
+        description: CONFIRM_WARNING +
+            'Create a multi-signer envelope around one PDF. After creating, add each signer with ' +
+            'add_session_to_envelope. Consumes quota.',
+        inputSchema: createEnvelopeShape,
+        annotations: DESTRUCTIVE,
+    }, async (args) => run(() => {
+        const req = {
+            signingMode: args.signingMode,
+            totalSigners: args.totalSigners,
+            document: { content: args.documentBase64, filename: args.documentFilename },
+            ...(args.metadata ? { metadata: args.metadata } : {}),
+            ...(args.locale ? { locale: args.locale } : {}),
+            ...(args.returnUrl ? { returnUrl: args.returnUrl } : {}),
+            ...(args.cancelUrl ? { cancelUrl: args.cancelUrl } : {}),
+            ...(args.expiresInMinutes ? { expiresInMinutes: args.expiresInMinutes } : {}),
+            ...(args.owner ? { owner: args.owner } : {}),
+        };
+        return getClient().envelopes.create(req, idempotencyKey(args.idempotencyKey));
+    }));
+    server.registerTool('get_envelope', {
+        title: 'Get envelope',
+        description: 'Get envelope details including per-signer session summaries and completion counts.',
+        inputSchema: envelopeIdShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().envelopes.get(args.envelopeId)));
+    server.registerTool('add_session_to_envelope', {
+        title: 'Add signer to envelope',
+        description: CONFIRM_WARNING +
+            'Add a signing session for one signer to an envelope. Returns IDs plus a ready-to-share `signingUrl`.',
+        inputSchema: addEnvelopeSessionShape,
+        annotations: DESTRUCTIVE,
+    }, async (args) => run(async () => {
+        const req = {
+            signer: args.signer,
+            policy: { profile: args.policyProfile },
+            signerIndex: args.signerIndex,
+            ...(args.purpose ? { purpose: args.purpose } : {}),
+            ...(args.returnUrl ? { returnUrl: args.returnUrl } : {}),
+            ...(args.cancelUrl ? { cancelUrl: args.cancelUrl } : {}),
+            ...(args.metadata ? { metadata: args.metadata } : {}),
+        };
+        const session = await getClient().envelopes.addSession(args.envelopeId, req);
+        return { ...session, signingUrl: buildSigningUrl(session.url, session.clientSecret) };
+    }));
+    server.registerTool('get_envelope_combined_stamp', {
+        title: 'Get envelope combined stamp',
+        description: 'Generate the combined stamped PDF (all signers) for a COMPLETED envelope and return a download URL.',
+        inputSchema: envelopeIdShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().envelopes.combinedStamp(args.envelopeId)));
+}
+//# sourceMappingURL=envelopes.js.map

package/dist/tools/envelopes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envelopes.js","sourceRoot":"","sources":["../../src/tools/envelopes.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE9F,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,eAAe;YACf,sFAAsF;YACtF,0CAA0C;QAC5C,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,WAAW;KACzB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,GAAG,CAAC,GAAG,EAAE;QACP,MAAM,GAAG,GAA0B;YACjC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,EAAE,IAAI,CAAC,gBAAgB,EAAE;YAC3E,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7E,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC7C,CAAC;QACF,OAAO,SAAS,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC;IAChF,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,oFAAoF;QACjG,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CACtE,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,yBAAyB,EACzB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,eAAe;YACf,sGAAsG;QACxG,WAAW,EAAE,uBAAuB;QACpC,WAAW,EAAE,WAAW;KACzB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,GAAG,CAAC,KAAK,IAAI,EAAE;QACb,MAAM,GAAG,GAA8B;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,aAAa,EAAE;YACvC,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxD,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC;QACF,MAAM,OAAO,GAAG,MAAM,SAAS,EAAE,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAC7E,OAAO,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;IACxF,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,6BAA6B,EAC7B;QACE,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,qGAAqG;QACvG,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAChF,CAAC;AACJ,CAAC"}

package/dist/tools/evidence.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerEvidenceTools(server: McpServer): void;

package/dist/tools/evidence.js

@@ -0,0 +1,13 @@
+import { getClient } from '../client.js';
+import { READ_ONLY } from '../annotations.js';
+import { run } from './helpers.js';
+import { transactionIdShape } from '../schemas.js';
+export function registerEvidenceTools(server) {
+    server.registerTool('get_evidence', {
+        title: 'Get evidence',
+        description: 'Retrieve the cryptographic evidence (hashes, step proofs, evidenceId) for a completed transaction.',
+        inputSchema: transactionIdShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().evidence.get(args.transactionId)));
+}
+//# sourceMappingURL=evidence.js.map

package/dist/tools/evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence.js","sourceRoot":"","sources":["../../src/tools/evidence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EACT,oGAAoG;QACtG,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CACxE,CAAC;AACJ,CAAC"}

package/dist/tools/helpers.d.ts

@@ -0,0 +1,20 @@
+/** MCP tool result shape (subset we use). Index signature matches the SDK's CallToolResult. */
+export interface ToolResult {
+    [key: string]: unknown;
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+    structuredContent?: Record<string, unknown>;
+}
+export declare function jsonContent(data: unknown): ToolResult;
+/**
+ * Normalize any thrown value (SDK errors are RFC-7807 ProblemDetail-bearing)
+ * into a clean, non-throwing MCP error result so the agent can read and react.
+ */
+export declare function errorContent(err: unknown): ToolResult;
+/** Run an SDK call and wrap success/failure into a tool result. */
+export declare function run(fn: () => Promise<unknown>): Promise<ToolResult>;
+/** Use the caller-supplied idempotency key, or mint a fresh UUID. */
+export declare function idempotencyKey(provided?: string): string;

package/dist/tools/helpers.js

@@ -0,0 +1,33 @@
+import { randomUUID } from 'node:crypto';
+export function jsonContent(data) {
+    return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+}
+/**
+ * Normalize any thrown value (SDK errors are RFC-7807 ProblemDetail-bearing)
+ * into a clean, non-throwing MCP error result so the agent can read and react.
+ */
+export function errorContent(err) {
+    const e = err;
+    const parts = [];
+    parts.push(`SignDocs API error: ${e?.message ?? String(err)}`);
+    if (typeof e?.status === 'number')
+        parts.push(`(HTTP ${e.status})`);
+    const problem = e?.problem ?? e?.detail;
+    if (problem)
+        parts.push(`\n${JSON.stringify(problem, null, 2)}`);
+    return { content: [{ type: 'text', text: parts.join(' ') }], isError: true };
+}
+/** Run an SDK call and wrap success/failure into a tool result. */
+export async function run(fn) {
+    try {
+        return jsonContent(await fn());
+    }
+    catch (err) {
+        return errorContent(err);
+    }
+}
+/** Use the caller-supplied idempotency key, or mint a fresh UUID. */
+export function idempotencyKey(provided) {
+    return provided ?? randomUUID();
+}
+//# sourceMappingURL=helpers.js.map

package/dist/tools/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/tools/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,GAAY;IACvC,MAAM,CAAC,GAAG,GAAiF,CAAC;IAC5F,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/D,IAAI,OAAO,CAAC,EAAE,MAAM,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IACpE,MAAM,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,MAAM,CAAC;IACxC,IAAI,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC/E,CAAC;AAED,mEAAmE;AACnE,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,EAA0B;IAClD,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,cAAc,CAAC,QAAiB;IAC9C,OAAO,QAAQ,IAAI,UAAU,EAAE,CAAC;AAClC,CAAC"}

package/dist/tools/signingSessions.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSigningSessionTools(server: McpServer): void;