faxseal-mcp 2.0.1 → 2.2.0

package/README.md

@@ -8,6 +8,7 @@ Send, receive, and verify faxes from AI assistants and agents via the [Model Con
 |---|---|
 | `send_fax` | Send a fax from a publicly accessible PDF URL |
 | `send_fax_text` | Type content directly — FaxSeal converts it to a PDF and sends |
+| `quote_fax` | Estimate pages and credits before sending |
 | `get_fax_status` | Check delivery status of a sent fax |
 | `get_credits` | Check your FaxSeal credit balance |
 | `list_received_faxes` | List faxes in your inbox with OCR text |

package/index.js

@@ -9,6 +9,7 @@ import {
 const BASE_URL = (process.env.FAXSEAL_BASE_URL ?? 'https://faxseal.com').replace(/\/+$/, '');
 const API_KEY  = process.env.FAXSEAL_API_KEY ?? '';
 const FETCH_TIMEOUT_MS = 30_000;
+const SERVER_VERSION = '2.2.0';
 
 if (!API_KEY) {
   process.stderr.write('Error: FAXSEAL_API_KEY environment variable is required.\n');
@@ -113,6 +114,34 @@ const handlers = {
     ]);
   },
 
+  quote_fax: async (args) => {
+    if (!args.to) throw new Error('to is required');
+    if (!args.pages && !args.content && !args.file_url) {
+      throw new Error('one of pages, content, or file_url is required');
+    }
+
+    const data = await apiFetch('/api/v1/fax/quote', {
+      method: 'POST',
+      headers: authHeaders(),
+      body: JSON.stringify({
+        to: args.to,
+        pages: args.pages,
+        content: args.content,
+        file_url: args.file_url,
+        subject: args.subject,
+      }),
+    });
+
+    return ok([
+      `To: ${data.to_number}`,
+      `Zone: ${data.zone}`,
+      `Pages: ${data.pages}`,
+      `Credits required: ${data.credits_required}`,
+      `Credits available: ${data.credits_available}`,
+      `Can send: ${data.can_send}`,
+    ]);
+  },
+
   get_fax_status: async (args) => {
     if (!args.job_id) throw new Error('job_id is required');
 
@@ -203,6 +232,37 @@ const handlers = {
 
     return ok(lines);
   },
+  open_pdf_editor: async (args) => {
+    if (!args.file_url) throw new Error('file_url is required');
+    const data = await apiFetch('/api/v1/pdf', {
+      method: 'POST',
+      headers: authHeaders(),
+      body: JSON.stringify({ file_url: args.file_url }),
+    });
+    return ok([
+      'PDF opened in the FaxSeal editor. Nothing has been edited, signed or sent yet.',
+      `Document ID: ${data.document_id}`,
+      `Pages: ${data.pages}`,
+      `Editor: ${data.editor_url}`,
+      `Link expires: ${data.expires_at}`,
+      'Give the user the editor link. They place their own text, dates and signature, click Apply and can download free.',
+      'Then call get_edited_pdf with this document ID. Ready means edits were applied; it does not verify a signature was added. Never claim it is signed unless the user confirms that.',
+    ]);
+  },
+
+  get_edited_pdf: async (args) => {
+    if (!args.document_id) throw new Error('document_id is required');
+    const data = await apiFetch(`/api/v1/pdf/${encodeURIComponent(args.document_id)}`, { headers: authHeaders() });
+    if (!data.ready) return ok([`Document ${args.document_id}: not finished yet. The user must apply their edits in the editor first.`]);
+    return ok([
+      `Document ${data.document_id} is ready.`,
+      `Pages: ${data.pages}`,
+      data.filename && `File: ${data.filename}`,
+      `Download: ${data.download_url}`,
+      `Download link expires: ${data.expires_at}`,
+      'Faxing is optional: only send this file with send_fax after the user explicitly approves the recipient and cost.',
+    ]);
+  },
 };
 
 // ---------------------------------------------------------------------------
@@ -242,6 +302,22 @@ const TOOL_DEFS = [
       },
     },
   },
+  {
+    name: 'quote_fax',
+    description:
+      'Estimate pages and credits for a fax before sending. Accepts known page count, plain text content, or a PDF URL.',
+    inputSchema: {
+      type: 'object',
+      required: ['to'],
+      properties: {
+        to:       { type: 'string', description: 'Destination fax number in E.164 format, e.g. +12025551234' },
+        pages:    { type: 'number', description: 'Known page count, if already available' },
+        content:  { type: 'string', description: 'Plain-text fax body to render and quote' },
+        file_url: { type: 'string', description: 'Publicly accessible HTTPS URL to a PDF file to quote' },
+        subject:  { type: 'string', description: 'Optional subject when quoting plain text content' },
+      },
+    },
+  },
   {
     name: 'get_fax_status',
     description:
@@ -289,6 +365,30 @@ const TOOL_DEFS = [
       },
     },
   },
+  {
+    name: 'open_pdf_editor',
+    description:
+      'Open a PDF from an HTTPS URL in the free FaxSeal editor so the user can add text, dates, checkboxes and their own signature, rotate or remove pages, and download. Does not send a fax or spend credits. Requires an API token with the "Edit and sign PDFs" permission on a personal account. The user must apply edits themselves; never claim the document is signed because this returned a link.',
+    inputSchema: {
+      type: 'object',
+      required: ['file_url'],
+      properties: {
+        file_url: { type: 'string', description: 'Publicly accessible HTTPS URL to a PDF file' },
+      },
+    },
+  },
+  {
+    name: 'get_edited_pdf',
+    description:
+      'Check whether the user has applied their edits to a document opened with open_pdf_editor. Returns not ready until they do, then a short-lived download URL that can also be passed to send_fax with separate user approval.',
+    inputSchema: {
+      type: 'object',
+      required: ['document_id'],
+      properties: {
+        document_id: { type: 'string', description: 'Document ID returned by open_pdf_editor' },
+      },
+    },
+  },
 ];
 
 // ---------------------------------------------------------------------------
@@ -296,7 +396,7 @@ const TOOL_DEFS = [
 // ---------------------------------------------------------------------------
 
 const server = new Server(
-  { name: 'faxseal-mcp', version: '2.0.0' },
+  { name: 'faxseal-mcp', version: SERVER_VERSION },
   { capabilities: { tools: {} } },
 );
 

package/package.json

@@ -1,14 +1,17 @@
 {
   "name": "faxseal-mcp",
-  "version": "2.0.1",
-  "description": "MCP server for FaxSeal — send, receive, and verify faxes from AI assistants and agents",
+  "version": "2.2.0",
+  "description": "MCP server for FaxSeal — send, receive, and verify faxes, and edit or sign PDFs free, from AI assistants and agents",
   "main": "index.js",
   "bin": {
     "faxseal-mcp": "index.js"
   },
   "type": "module",
   "files": [
-    "index.js"
+    "index.js",
+    "server-http.js",
+    "server.json",
+    "smithery.yaml"
   ],
   "engines": {
     "node": ">=20"
@@ -33,7 +36,7 @@
   "homepage": "https://faxseal.com/api",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/faxseal/mcp-server.git"
+    "url": "git+https://github.com/grichardomi/mcp-server.git"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0"

package/server-http.js

@@ -0,0 +1,452 @@
+#!/usr/bin/env node
+/**
+ * FaxSeal MCP HTTP Server (Railway / cloud deployment)
+ * Implements MCP Streamable HTTP transport — one session per caller.
+ * Callers authenticate with their own FAXSEAL_API_KEY via Bearer token.
+ */
+import { randomUUID } from 'node:crypto';
+import { createServer } from 'node:http';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+
+const PORT = parseInt(process.env.PORT ?? '3001', 10);
+const BASE_URL = (process.env.FAXSEAL_BASE_URL ?? 'https://faxseal.com').replace(/\/+$/, '');
+const FETCH_TIMEOUT_MS = 30_000;
+const SERVER_VERSION = '2.2.0';
+
+// ---------------------------------------------------------------------------
+// HTTP helper — per-request API key, hard timeout, no timer leaks
+// ---------------------------------------------------------------------------
+
+function makeApiFetch(apiKey) {
+  return async function apiFetch(path, options = {}) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+    try {
+      const res = await fetch(`${BASE_URL}${path}`, {
+        ...options,
+        signal: controller.signal,
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          'Content-Type': 'application/json',
+          ...options.headers,
+        },
+      });
+      const contentType = res.headers.get('content-type') ?? '';
+      const body = contentType.includes('application/json')
+        ? await res.json().catch(() => null)
+        : await res.text().catch(() => '');
+      if (!res.ok) {
+        const message =
+          body && typeof body === 'object' && 'error' in body
+            ? body.error
+            : typeof body === 'string' && body.trim()
+              ? body.trim()
+              : `HTTP ${res.status}`;
+        throw new Error(String(message));
+      }
+      return body && typeof body === 'object' ? body : {};
+    } finally {
+      clearTimeout(timer);
+    }
+  };
+}
+
+function ok(lines) {
+  return { content: [{ type: 'text', text: lines.filter(Boolean).join('\n') }] };
+}
+
+function toolErr(message) {
+  return { content: [{ type: 'text', text: `Error: ${message}` }], isError: true };
+}
+
+// ---------------------------------------------------------------------------
+// Tool handlers — factory bound to a single session's API key
+// ---------------------------------------------------------------------------
+
+function makeHandlers(apiFetch) {
+  return {
+    send_fax: async (args) => {
+      if (!args.to) throw new Error('to is required');
+      if (!args.file_url) throw new Error('file_url is required');
+      const data = await apiFetch('/api/zapier/send', {
+        method: 'POST',
+        body: JSON.stringify({
+          to: args.to,
+          file_url: args.file_url,
+          from_name: args.from_name,
+          from_company: args.from_company,
+          subject: args.subject,
+          notes: args.notes,
+        }),
+      });
+      return ok([
+        'Fax queued.',
+        `Job ID: ${data.id}`,
+        `To: ${data.to_number}`,
+        `Pages: ${data.pages}`,
+        `Credits used: ${data.credits_used} (${data.credits_remaining} remaining)`,
+        `Track: ${data.track_url}`,
+      ]);
+    },
+
+    send_fax_text: async (args) => {
+      if (!args.to) throw new Error('to is required');
+      if (!args.content) throw new Error('content is required');
+      const data = await apiFetch('/api/v1/fax/text', {
+        method: 'POST',
+        body: JSON.stringify({
+          to: args.to,
+          content: args.content,
+          subject: args.subject,
+          from_name: args.from_name,
+          from_company: args.from_company,
+        }),
+      });
+      return ok([
+        'Fax queued.',
+        `Job ID: ${data.id}`,
+        `To: ${data.to_number}`,
+        `Pages: ${data.pages}`,
+        `Credits used: ${data.credits_used} (${data.credits_remaining} remaining)`,
+        `Track: ${data.track_url}`,
+      ]);
+    },
+
+    quote_fax: async (args) => {
+      if (!args.to) throw new Error('to is required');
+      if (!args.pages && !args.content && !args.file_url) {
+        throw new Error('one of pages, content, or file_url is required');
+      }
+      const data = await apiFetch('/api/v1/fax/quote', {
+        method: 'POST',
+        body: JSON.stringify({
+          to: args.to,
+          pages: args.pages,
+          content: args.content,
+          file_url: args.file_url,
+          subject: args.subject,
+        }),
+      });
+      return ok([
+        `To: ${data.to_number}`,
+        `Zone: ${data.zone}`,
+        `Pages: ${data.pages}`,
+        `Credits required: ${data.credits_required}`,
+        `Credits available: ${data.credits_available}`,
+        `Can send: ${data.can_send}`,
+      ]);
+    },
+
+    get_fax_status: async (args) => {
+      if (!args.job_id) throw new Error('job_id is required');
+      const data = await apiFetch(`/api/v1/fax/${encodeURIComponent(args.job_id)}`);
+      return ok([
+        `Status: ${data.status}`,
+        `To: ${data.toNumber}`,
+        `Pages: ${data.pages}`,
+        data.creditsUsed != null && `Credits used: ${data.creditsUsed}`,
+        data.failureReason && `Failure reason: ${data.failureReason}`,
+        data.refundStatus && `Refund: ${data.refundStatus}`,
+        data.certReceiptUrl && `Receipt: ${data.certReceiptUrl}`,
+        `Sent: ${data.createdAt}`,
+        `Updated: ${data.updatedAt}`,
+      ]);
+    },
+
+    get_credits: async () => {
+      const data = await apiFetch('/api/user/credits');
+      return ok([`Credit balance: ${data.credits}`]);
+    },
+
+    list_received_faxes: async (args) => {
+      const params = new URLSearchParams();
+      if (args.since) params.set('since', args.since);
+      const qs = params.size ? `?${params}` : '';
+      const faxes = await apiFetch(`/api/zapier/inbox${qs}`);
+      if (!faxes.length) return ok(['No received faxes found.']);
+      const lines = [`${faxes.length} received fax(es):`, ''];
+      for (let i = 0; i < faxes.length; i++) {
+        const f = faxes[i];
+        if (i > 0) lines.push('─'.repeat(40));
+        lines.push(
+          `ID: ${f.id}`,
+          `From: ${f.from_number}  To: ${f.to_number}  Pages: ${f.pages}`,
+          `Received: ${f.received_at}`,
+          f.ocr_text
+            ? `Text preview: ${f.ocr_text.slice(0, 200)}${f.ocr_text.length > 200 ? '…' : ''}`
+            : 'OCR: not available',
+        );
+      }
+      return ok(lines);
+    },
+
+    verify_fax: async (args) => {
+      if (!args.job_id) throw new Error('job_id is required');
+      const data = await apiFetch(`/api/v1/fax/${encodeURIComponent(args.job_id)}/verify`);
+      if (!data.attested) {
+        return ok([`Job ${args.job_id}: not yet attested (status: ${data.status})`]);
+      }
+      const lines = [
+        `Job ID: ${data.jobId}`,
+        `Status: ${data.status}`,
+        data.documentHash && `Document hash (SHA-256): ${data.documentHash}`,
+      ];
+      if (data.send) {
+        lines.push('', 'Send attestation:',
+          `  Verified: ${data.send.verified}`,
+          `  Rekor: ${data.send.rekorUrl}`,
+          data.send.error && `  Error: ${data.send.error}`);
+      }
+      if (data.delivery) {
+        lines.push('', 'Delivery attestation:',
+          `  Verified: ${data.delivery.verified}`,
+          `  Rekor: ${data.delivery.rekorUrl}`,
+          data.delivery.error && `  Error: ${data.delivery.error}`);
+      }
+      return ok(lines);
+    },
+    open_pdf_editor: async (args) => {
+      if (!args.file_url) throw new Error('file_url is required');
+      const data = await apiFetch('/api/v1/pdf', {
+        method: 'POST',
+        body: JSON.stringify({ file_url: args.file_url }),
+      });
+      return ok([
+        'PDF opened in the FaxSeal editor. Nothing has been edited, signed or sent yet.',
+        `Document ID: ${data.document_id}`,
+        `Pages: ${data.pages}`,
+        `Editor: ${data.editor_url}`,
+        `Link expires: ${data.expires_at}`,
+        'Give the user the editor link. They place their own text, dates and signature, click Apply and can download free.',
+        'Then call get_edited_pdf with this document ID. Ready means edits were applied; it does not verify a signature was added. Never claim it is signed unless the user confirms that.',
+      ]);
+    },
+
+    get_edited_pdf: async (args) => {
+      if (!args.document_id) throw new Error('document_id is required');
+      const data = await apiFetch(`/api/v1/pdf/${encodeURIComponent(args.document_id)}`);
+      if (!data.ready) return ok([`Document ${args.document_id}: not finished yet. The user must apply their edits in the editor first.`]);
+      return ok([
+        `Document ${data.document_id} is ready.`,
+        `Pages: ${data.pages}`,
+        data.filename && `File: ${data.filename}`,
+        `Download: ${data.download_url}`,
+        `Download link expires: ${data.expires_at}`,
+        'Faxing is optional: only send this file with send_fax after the user explicitly approves the recipient and cost.',
+      ]);
+    },
+  };
+}
+
+// ---------------------------------------------------------------------------
+// Tool definitions
+// ---------------------------------------------------------------------------
+
+const TOOL_DEFS = [
+  {
+    name: 'send_fax',
+    description: 'Send a fax from a publicly accessible PDF URL. Returns a job ID for status tracking.',
+    inputSchema: {
+      type: 'object', required: ['to', 'file_url'],
+      properties: {
+        to:           { type: 'string', description: 'Destination fax number in E.164 format, e.g. +12025551234' },
+        file_url:     { type: 'string', description: 'Publicly accessible HTTPS URL to a PDF file' },
+        from_name:    { type: 'string', description: 'Sender name for the cover page (optional)' },
+        from_company: { type: 'string', description: 'Sender company for the cover page (optional)' },
+        subject:      { type: 'string', description: 'Fax subject line (optional)' },
+        notes:        { type: 'string', description: 'Cover page notes (optional)' },
+      },
+    },
+  },
+  {
+    name: 'send_fax_text',
+    description: 'Convert plain text to a PDF and send it as a fax. Ideal when the content is generated at runtime.',
+    inputSchema: {
+      type: 'object', required: ['to', 'content'],
+      properties: {
+        to:           { type: 'string', description: 'Destination fax number in E.164 format, e.g. +12025551234' },
+        content:      { type: 'string', description: 'Plain-text body of the fax (max 50,000 characters)' },
+        subject:      { type: 'string', description: 'Fax subject line (optional)' },
+        from_name:    { type: 'string', description: 'Sender name (optional)' },
+        from_company: { type: 'string', description: 'Sender company (optional)' },
+      },
+    },
+  },
+  {
+    name: 'quote_fax',
+    description: 'Estimate pages and credits for a fax before sending. Accepts known page count, plain text content, or a PDF URL.',
+    inputSchema: {
+      type: 'object', required: ['to'],
+      properties: {
+        to:       { type: 'string', description: 'Destination fax number in E.164 format, e.g. +12025551234' },
+        pages:    { type: 'number', description: 'Known page count, if already available' },
+        content:  { type: 'string', description: 'Plain-text fax body to render and quote' },
+        file_url: { type: 'string', description: 'Publicly accessible HTTPS URL to a PDF file to quote' },
+        subject:  { type: 'string', description: 'Optional subject when quoting plain text content' },
+      },
+    },
+  },
+  {
+    name: 'get_fax_status',
+    description: 'Check the delivery status of a sent fax. Status: queued → sending → delivered or failed.',
+    inputSchema: {
+      type: 'object', required: ['job_id'],
+      properties: {
+        job_id: { type: 'string', description: 'Fax job ID returned by send_fax or send_fax_text' },
+      },
+    },
+  },
+  {
+    name: 'get_credits',
+    description: 'Check the current FaxSeal credit balance for this API token.',
+    inputSchema: { type: 'object', properties: {} },
+  },
+  {
+    name: 'list_received_faxes',
+    description: 'List faxes received in the inbox, newest first (up to 50). Includes OCR text when available.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        since: { type: 'string', description: 'ISO 8601 date-time — return only faxes received after this point. Defaults to last 7 days.' },
+      },
+    },
+  },
+  {
+    name: 'verify_fax',
+    description: 'Verify the cryptographic attestation of a fax via Sigstore/Rekor. Confirms delivery without tampering.',
+    inputSchema: {
+      type: 'object', required: ['job_id'],
+      properties: {
+        job_id: { type: 'string', description: 'Fax job ID to verify' },
+      },
+    },
+  },
+  {
+    name: 'open_pdf_editor',
+    description:
+      'Open a PDF from an HTTPS URL in the free FaxSeal editor so the user can add text, dates, checkboxes and their own signature, rotate or remove pages, and download. Does not send a fax or spend credits. Requires an API token with the "Edit and sign PDFs" permission on a personal account. The user must apply edits themselves; never claim the document is signed because this returned a link.',
+    inputSchema: {
+      type: 'object',
+      required: ['file_url'],
+      properties: {
+        file_url: { type: 'string', description: 'Publicly accessible HTTPS URL to a PDF file' },
+      },
+    },
+  },
+  {
+    name: 'get_edited_pdf',
+    description:
+      'Check whether the user has applied their edits to a document opened with open_pdf_editor. Returns not ready until they do, then a short-lived download URL that can also be passed to send_fax with separate user approval.',
+    inputSchema: {
+      type: 'object',
+      required: ['document_id'],
+      properties: {
+        document_id: { type: 'string', description: 'Document ID returned by open_pdf_editor' },
+      },
+    },
+  },
+];
+
+// ---------------------------------------------------------------------------
+// MCP server factory — one instance per session
+// ---------------------------------------------------------------------------
+
+function buildMcpServer(apiKey) {
+  const apiFetch = makeApiFetch(apiKey);
+  const handlers = makeHandlers(apiFetch);
+
+  const server = new Server(
+    { name: 'faxseal-mcp', version: SERVER_VERSION },
+    { capabilities: { tools: {} } },
+  );
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOL_DEFS }));
+
+  server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args = {} } = req.params;
+    const handler = handlers[name];
+    if (!handler) return toolErr(`Unknown tool: ${name}`);
+    try {
+      return await handler(args);
+    } catch (e) {
+      return toolErr(e instanceof Error ? e.message : String(e));
+    }
+  });
+
+  return server;
+}
+
+// ---------------------------------------------------------------------------
+// HTTP server — session registry with cleanup
+// ---------------------------------------------------------------------------
+
+// sessionId -> StreamableHTTPServerTransport
+const sessions = new Map();
+
+const httpServer = createServer(async (req, res) => {
+  const url = new URL(req.url ?? '/', `http://localhost:${PORT}`);
+
+  if (url.pathname === '/health') {
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ ok: true, sessions: sessions.size }));
+    return;
+  }
+
+  // OAuth Resource Server metadata (RFC 9728) — tells clients we use bearer tokens, not OAuth
+  if (url.pathname === '/.well-known/oauth-protected-resource') {
+    const resource = `https://${req.headers.host}`;
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({
+      resource,
+      bearer_methods_supported: ['header', 'query'],
+      resource_documentation: 'https://faxseal.com/docs/api',
+    }));
+    return;
+  }
+
+  if (url.pathname === '/mcp') {
+    const authHeader = req.headers['authorization'] ?? '';
+    const apiKey = authHeader.startsWith('Bearer ')
+      ? authHeader.slice(7)
+      : url.searchParams.get('apiKey') ?? '';
+
+    if (!apiKey) {
+      res.writeHead(401, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ error: 'Authorization: Bearer <FAXSEAL_API_KEY> required' }));
+      return;
+    }
+
+    // Re-use existing session if client sends Mcp-Session-Id
+    const existingId = req.headers['mcp-session-id'];
+    if (typeof existingId === 'string' && sessions.has(existingId)) {
+      await sessions.get(existingId).handleRequest(req, res);
+      return;
+    }
+
+    // New session
+    const transport = new StreamableHTTPServerTransport({
+      sessionIdGenerator: () => randomUUID(),
+      onsessioninitialized: (sessionId) => {
+        sessions.set(sessionId, transport);
+      },
+    });
+
+    transport.onclose = () => {
+      if (transport.sessionId) sessions.delete(transport.sessionId);
+    };
+
+    const server = buildMcpServer(apiKey);
+    await server.connect(transport);
+    await transport.handleRequest(req, res);
+    return;
+  }
+
+  res.writeHead(404, { 'Content-Type': 'text/plain' });
+  res.end('Not found');
+});
+
+httpServer.listen(PORT, '0.0.0.0', () => {
+  process.stderr.write(`FaxSeal MCP HTTP server listening on port ${PORT}\n`);
+});

package/server.json

@@ -0,0 +1,34 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.grichardomi/faxseal",
+  "title": "FaxSeal",
+  "description": "Send, receive, and verify faxes from AI assistants and agents via FaxSeal.",
+  "version": "2.2.0",
+  "repository": {
+    "url": "https://github.com/grichardomi/mcp-server",
+    "source": "github"
+  },
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://mcp-server-production-8f66.up.railway.app/mcp"
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "npm",
+      "name": "faxseal-mcp",
+      "identifier": "faxseal-mcp",
+      "version": "2.2.0",
+      "runtime": "node",
+      "transport": { "type": "stdio" },
+      "environmentVariables": [
+        {
+          "name": "FAXSEAL_API_KEY",
+          "description": "Your FaxSeal API key (fsx_...). Generate one at https://faxseal.com/dashboard/api-tokens",
+          "required": true
+        }
+      ]
+    }
+  ]
+}

package/smithery.yaml

@@ -0,0 +1,13 @@
+startCommand:
+  type: http
+  url: https://mcp-server-production-8f66.up.railway.app/mcp
+  configSchema:
+    type: object
+    required:
+      - apiKey
+    properties:
+      apiKey:
+        type: string
+        description: Your FaxSeal API key (fsx_...). Generate one at https://faxseal.com/dashboard/api-tokens
+  exampleConfig:
+    apiKey: fsx_your_token_here