@signdocs-brasil/mcp-server 0.1.0

package/dist/tools/signingSessions.js

@@ -0,0 +1,70 @@
+import { getClient, buildSigningUrl } from '../client.js';
+import { CONFIRM_WARNING, DESTRUCTIVE, READ_ONLY, WRITE_SAFE } from '../annotations.js';
+import { run, idempotencyKey } from './helpers.js';
+import { createSigningSessionShape, sessionIdShape, listSigningSessionsShape, resendOtpShape, } from '../schemas.js';
+export function registerSigningSessionTools(server) {
+    server.registerTool('create_signing_session', {
+        title: 'Create signing session',
+        description: CONFIRM_WARNING +
+            'Create a single-signer "express" signing (or action-authentication) session and return its ' +
+            'IDs plus a ready-to-share `signingUrl` (url + embed token). Consumes signature quota.',
+        inputSchema: createSigningSessionShape,
+        annotations: DESTRUCTIVE,
+    }, async (args) => run(async () => {
+        const req = {
+            purpose: args.purpose,
+            policy: {
+                profile: args.policyProfile,
+                ...(args.customSteps ? { customSteps: args.customSteps } : {}),
+            },
+            signer: args.signer,
+            ...(args.documentBase64
+                ? { document: { content: args.documentBase64, filename: args.documentFilename } }
+                : {}),
+            ...(args.action ? { action: args.action } : {}),
+            ...(args.returnUrl ? { returnUrl: args.returnUrl } : {}),
+            ...(args.cancelUrl ? { cancelUrl: args.cancelUrl } : {}),
+            ...(args.metadata ? { metadata: args.metadata } : {}),
+            ...(args.locale ? { locale: args.locale } : {}),
+            ...(args.expiresInMinutes ? { expiresInMinutes: args.expiresInMinutes } : {}),
+            ...(args.owner ? { owner: args.owner } : {}),
+        };
+        const session = await getClient().signingSessions.create(req, idempotencyKey(args.idempotencyKey));
+        return { ...session, signingUrl: buildSigningUrl(session.url, session.clientSecret) };
+    }));
+    server.registerTool('get_signing_session_status', {
+        title: 'Get signing session status',
+        description: 'Poll the current status of a signing session (ACTIVE/COMPLETED/CANCELLED/EXPIRED/FAILED).',
+        inputSchema: sessionIdShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().signingSessions.getStatus(args.sessionId)));
+    server.registerTool('get_signing_session', {
+        title: 'Get signing session details',
+        description: 'Get full bootstrap data for a signing session (signer, steps, document, appearance).',
+        inputSchema: sessionIdShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().signingSessions.get(args.sessionId)));
+    server.registerTool('list_signing_sessions', {
+        title: 'List signing sessions',
+        description: 'List signing sessions filtered by status, with cursor pagination.',
+        inputSchema: listSigningSessionsShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().signingSessions.list({
+        status: args.status,
+        ...(args.limit !== undefined ? { limit: args.limit } : {}),
+        ...(args.cursor ? { cursor: args.cursor } : {}),
+    })));
+    server.registerTool('cancel_signing_session', {
+        title: 'Cancel signing session',
+        description: CONFIRM_WARNING + 'Cancel an active signing session. This cannot be undone.',
+        inputSchema: sessionIdShape,
+        annotations: DESTRUCTIVE,
+    }, async (args) => run(() => getClient().signingSessions.cancel(args.sessionId)));
+    server.registerTool('resend_signing_session_otp', {
+        title: 'Resend signing session OTP',
+        description: 'Resend the OTP challenge for a signing session, optionally over a specific channel (email/sms).',
+        inputSchema: resendOtpShape,
+        annotations: WRITE_SAFE,
+    }, async (args) => run(() => getClient().signingSessions.resendOtp(args.sessionId, args.channel ? { channel: args.channel } : undefined)));
+}
+//# sourceMappingURL=signingSessions.js.map

package/dist/tools/signingSessions.js.map

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

package/dist/tools/transactions.d.ts

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

package/dist/tools/transactions.js

@@ -0,0 +1,37 @@
+import { getClient } from '../client.js';
+import { CONFIRM_WARNING, DESTRUCTIVE, READ_ONLY } from '../annotations.js';
+import { run } from './helpers.js';
+import { listTransactionsShape, transactionIdShape } from '../schemas.js';
+export function registerTransactionTools(server) {
+    server.registerTool('list_transactions', {
+        title: 'List / find transactions',
+        description: 'Search transactions by status, signer external ID, document group, or date range (cursor pagination). ' +
+            'Use this to find a transaction or check signing history.',
+        inputSchema: listTransactionsShape,
+        annotations: READ_ONLY,
+    }, async (args) => {
+        const params = {
+            ...(args.status ? { status: args.status } : {}),
+            ...(args.userExternalId ? { userExternalId: args.userExternalId } : {}),
+            ...(args.documentGroupId ? { documentGroupId: args.documentGroupId } : {}),
+            ...(args.limit !== undefined ? { limit: args.limit } : {}),
+            ...(args.nextToken ? { nextToken: args.nextToken } : {}),
+            ...(args.startDate ? { startDate: args.startDate } : {}),
+            ...(args.endDate ? { endDate: args.endDate } : {}),
+        };
+        return run(() => getClient().transactions.list(params));
+    });
+    server.registerTool('get_transaction', {
+        title: 'Get transaction',
+        description: 'Get full details of a single transaction, including its steps and results.',
+        inputSchema: transactionIdShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().transactions.get(args.transactionId)));
+    server.registerTool('cancel_transaction', {
+        title: 'Cancel transaction',
+        description: CONFIRM_WARNING + 'Cancel a low-level transaction. This cannot be undone.',
+        inputSchema: transactionIdShape,
+        annotations: DESTRUCTIVE,
+    }, async (args) => run(() => getClient().transactions.cancel(args.transactionId)));
+}
+//# sourceMappingURL=transactions.js.map

package/dist/tools/transactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transactions.js","sourceRoot":"","sources":["../../src/tools/transactions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAE1E,MAAM,UAAU,wBAAwB,CAAC,MAAiB;IACxD,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,wGAAwG;YACxG,0DAA0D;QAC5D,WAAW,EAAE,qBAAqB;QAClC,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,MAAM,GAA0B;YACpC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAA2B,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1E,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1D,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,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC;QACF,OAAO,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1D,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EAAE,4EAA4E;QACzF,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAC5E,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,oBAAoB,EACpB;QACE,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EAAE,eAAe,GAAG,wDAAwD;QACvF,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,WAAW;KACzB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAC/E,CAAC;AACJ,CAAC"}

package/dist/tools/verify.d.ts

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

package/dist/tools/verify.js

@@ -0,0 +1,39 @@
+import { getClient, getResolvedEnv } from '../client.js';
+import { CONFIRM_WARNING, DESTRUCTIVE, READ_ONLY } from '../annotations.js';
+import { run, errorContent } from './helpers.js';
+import { verifyEvidenceShape, verifyEnvelopeShape, verifyDocumentShape } from '../schemas.js';
+export function registerVerifyTools(server) {
+    server.registerTool('verify_evidence', {
+        title: 'Verify evidence (public)',
+        description: 'Publicly verify a completed signature by its evidenceId. Returns status, document/evidence hashes, ' +
+            'steps and signer display info. No authentication needed.',
+        inputSchema: verifyEvidenceShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().verification.verify(args.evidenceId)));
+    server.registerTool('verify_envelope', {
+        title: 'Verify envelope (public)',
+        description: 'Publicly verify all signers of an envelope and get consolidated download URLs.',
+        inputSchema: verifyEnvelopeShape,
+        annotations: READ_ONLY,
+    }, async (args) => run(() => getClient().verification.verifyEnvelope(args.envelopeId)));
+    server.registerTool('verify_document', {
+        title: 'Verify document signatures',
+        description: CONFIRM_WARNING +
+            'Inspect an uploaded PDF for embedded electronic/digital signatures. ' +
+            'Requires PRODUCTION credentials + the verification:write scope and CONSUMES verification quota. ' +
+            'Not available in HML.',
+        inputSchema: verifyDocumentShape,
+        annotations: DESTRUCTIVE,
+    }, async (args) => {
+        const env = getResolvedEnv();
+        if (env.environment !== 'production') {
+            return errorContent(new Error('verify_document is PRODUCTION-only — the signature-detection backend is not provisioned in HML. ' +
+                'Set SIGNDOCS_ENVIRONMENT=production with a production credential to use it.'));
+        }
+        return run(() => getClient().verification.verifyDocument({
+            content: args.documentBase64,
+            ...(args.filename ? { filename: args.filename } : {}),
+        }));
+    });
+}
+//# sourceMappingURL=verify.js.map

package/dist/tools/verify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify.js","sourceRoot":"","sources":["../../src/tools/verify.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAE9F,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,qGAAqG;YACrG,0DAA0D;QAC5D,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAC5E,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,0BAA0B;QACjC,WAAW,EAAE,gFAAgF;QAC7F,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CACpF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,eAAe;YACf,sEAAsE;YACtE,kGAAkG;YAClG,uBAAuB;QACzB,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE,WAAW;KACzB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;QAC7B,IAAI,GAAG,CAAC,WAAW,KAAK,YAAY,EAAE,CAAC;YACrC,OAAO,YAAY,CACjB,IAAI,KAAK,CACP,kGAAkG;gBAChG,6EAA6E,CAChF,CACF,CAAC;QACJ,CAAC;QACD,OAAO,GAAG,CAAC,GAAG,EAAE,CACd,SAAS,EAAE,CAAC,YAAY,CAAC,cAAc,CAAC;YACtC,OAAO,EAAE,IAAI,CAAC,cAAc;YAC5B,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC,CACH,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/webhooks.d.ts

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

package/dist/tools/webhooks.js

@@ -0,0 +1,35 @@
+import { getClient } from '../client.js';
+import { CONFIRM_WARNING, DESTRUCTIVE, READ_ONLY, WRITE_SAFE } from '../annotations.js';
+import { run } from './helpers.js';
+import { registerWebhookShape, webhookIdShape } from '../schemas.js';
+export function registerWebhookTools(server) {
+    server.registerTool('register_webhook', {
+        title: 'Register webhook',
+        description: 'Register an HTTPS endpoint to receive event notifications. The response returns a signing secret ' +
+            '— store it to verify the HMAC-SHA256 signature on incoming payloads.',
+        inputSchema: registerWebhookShape,
+        annotations: WRITE_SAFE,
+    }, async (args) => run(() => getClient().webhooks.register({ url: args.url, events: args.events })));
+    server.registerTool('list_webhooks', {
+        title: 'List webhooks',
+        description: 'List all registered webhooks for the tenant.',
+        inputSchema: {},
+        annotations: READ_ONLY,
+    }, async () => run(() => getClient().webhooks.list()));
+    server.registerTool('delete_webhook', {
+        title: 'Delete webhook',
+        description: CONFIRM_WARNING + 'Delete a registered webhook. Event delivery to it stops immediately.',
+        inputSchema: webhookIdShape,
+        annotations: DESTRUCTIVE,
+    }, async (args) => run(async () => {
+        await getClient().webhooks.delete(args.webhookId);
+        return { webhookId: args.webhookId, deleted: true };
+    }));
+    server.registerTool('test_webhook', {
+        title: 'Test webhook',
+        description: 'Send a sample payload to a registered webhook and return the delivery result.',
+        inputSchema: webhookIdShape,
+        annotations: WRITE_SAFE,
+    }, async (args) => run(() => getClient().webhooks.test(args.webhookId)));
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACxF,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAErE,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,kBAAkB;QACzB,WAAW,EACT,mGAAmG;YACnG,sEAAsE;QACxE,WAAW,EAAE,oBAAoB;QACjC,WAAW,EAAE,UAAU;KACxB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,GAAG,CAAC,GAAG,EAAE,CACP,SAAS,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAA4B,EAAE,CAAC,CAC5F,CACJ,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,8CAA8C;QAC3D,WAAW,EAAE,EAAE;QACf,WAAW,EAAE,SAAS;KACvB,EACD,KAAK,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CACnD,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,gBAAgB,EAChB;QACE,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,eAAe,GAAG,sEAAsE;QACrG,WAAW,EAAE,cAAc;QAC3B,WAAW,EAAE,WAAW;KACzB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CACb,GAAG,CAAC,KAAK,IAAI,EAAE;QACb,MAAM,SAAS,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAClD,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACtD,CAAC,CAAC,CACL,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,cAAc,EACd;QACE,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,+EAA+E;QAC5F,WAAW,EAAE,cAAc;QAC3B,WAAW,EAAE,UAAU;KACxB,EACD,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CACrE,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@signdocs-brasil/mcp-server",
+  "version": "0.1.0",
+  "description": "Model Context Protocol (MCP) server for the SignDocs Brasil e-signature API — lets AI agents create signing sessions, manage envelopes, verify documents and more.",
+  "license": "MIT",
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "signdocs-mcp": "dist/bin/stdio.js"
+  },
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/bin/stdio.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "inspect": "npm run build && npx @modelcontextprotocol/inspector node dist/bin/stdio.js",
+    "start": "node dist/bin/stdio.js",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "signdocs",
+    "e-signature",
+    "assinatura-eletronica",
+    "icp-brasil",
+    "ai",
+    "llm"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@signdocs-brasil/api": "^1.6.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0"
+  }
+}