faxforagents-mcp 0.4.2 → 0.4.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.4.3 (2026-11-09)
4
+
5
+ `quote_fax` takes `sender_name` (the station name in the fax header) and `delete_after_send`. The tool definitions, guide and output schemas follow API 1.12.0. The resolution text names the measured figures.
6
+
3
7
  ## 0.4.2 (2026-11-09)
4
8
 
5
9
  `quote_fax` takes `quality`: standard, fine (the default), superfine or ultra. The quote text names the level. Same price at every level. Needs API 1.11.0.
package/dist/index.js CHANGED
@@ -13,7 +13,7 @@ import { createHash } from "crypto";
13
13
  import { z as z3 } from "zod";
14
14
 
15
15
  // src/version.ts
16
- var VERSION = "0.4.2";
16
+ var VERSION = "0.4.3";
17
17
 
18
18
  // src/api.ts
19
19
  var DEFAULT_BASE_URL = "https://api.faxforagents.com";
@@ -137,7 +137,9 @@ An empty result cannot prove no fax was sent. Never replace an uncertain send wi
137
137
  (GET /v1/documents); the tool reads one id.
138
138
  3. quote_fax(document_id, to, cover?, quality?): the exact price for that document hash to that
139
139
  number. The cover sheet, when you pass one, is a billable page and the quote says so. quality
140
- picks the resolution (standard, fine, superfine, ultra; fine by default, same price). A quote lives
140
+ picks the resolution (standard, fine, superfine, ultra; fine by default, same price). sender_name
141
+ is the station name in the fax header. delete_after_send removes the document and the transmitted
142
+ copy when the fax ends; the receipt and the evidence stay. A quote lives
141
143
  10 minutes and is used by exactly one send. The quote carries the policy verdict under
142
144
  policy: decision (allow or deny), the first failing rule, and approval_required, which says
143
145
  whether a person must approve it. It is the same evaluation the server runs at send time.
@@ -359,6 +361,11 @@ var output_schemas_default = {
359
361
  title: "Currency",
360
362
  type: "string"
361
363
  },
364
+ delete_after_send: {
365
+ default: false,
366
+ title: "Delete After Send",
367
+ type: "boolean"
368
+ },
362
369
  direction: {
363
370
  title: "Direction",
364
371
  type: "string"
@@ -459,6 +466,18 @@ var output_schemas_default = {
459
466
  title: "Route",
460
467
  type: "string"
461
468
  },
469
+ sender_name: {
470
+ anyOf: [
471
+ {
472
+ type: "string"
473
+ },
474
+ {
475
+ type: "null"
476
+ }
477
+ ],
478
+ default: null,
479
+ title: "Sender Name"
480
+ },
462
481
  state: {
463
482
  enum: [
464
483
  "queued",
@@ -1631,6 +1650,11 @@ var output_schemas_default = {
1631
1650
  title: "Currency",
1632
1651
  type: "string"
1633
1652
  },
1653
+ delete_after_send: {
1654
+ default: false,
1655
+ title: "Delete After Send",
1656
+ type: "boolean"
1657
+ },
1634
1658
  direction: {
1635
1659
  title: "Direction",
1636
1660
  type: "string"
@@ -1731,6 +1755,18 @@ var output_schemas_default = {
1731
1755
  title: "Route",
1732
1756
  type: "string"
1733
1757
  },
1758
+ sender_name: {
1759
+ anyOf: [
1760
+ {
1761
+ type: "string"
1762
+ },
1763
+ {
1764
+ type: "null"
1765
+ }
1766
+ ],
1767
+ default: null,
1768
+ title: "Sender Name"
1769
+ },
1734
1770
  state: {
1735
1771
  enum: [
1736
1772
  "queued",
@@ -2261,6 +2297,11 @@ var output_schemas_default = {
2261
2297
  title: "Currency",
2262
2298
  type: "string"
2263
2299
  },
2300
+ delete_after_send: {
2301
+ default: false,
2302
+ title: "Delete After Send",
2303
+ type: "boolean"
2304
+ },
2264
2305
  direction: {
2265
2306
  title: "Direction",
2266
2307
  type: "string"
@@ -2361,6 +2402,18 @@ var output_schemas_default = {
2361
2402
  title: "Route",
2362
2403
  type: "string"
2363
2404
  },
2405
+ sender_name: {
2406
+ anyOf: [
2407
+ {
2408
+ type: "string"
2409
+ },
2410
+ {
2411
+ type: "null"
2412
+ }
2413
+ ],
2414
+ default: null,
2415
+ title: "Sender Name"
2416
+ },
2364
2417
  state: {
2365
2418
  enum: [
2366
2419
  "queued",
@@ -2901,6 +2954,11 @@ var output_schemas_default = {
2901
2954
  title: "Currency",
2902
2955
  type: "string"
2903
2956
  },
2957
+ delete_after_send: {
2958
+ default: false,
2959
+ title: "Delete After Send",
2960
+ type: "boolean"
2961
+ },
2904
2962
  document_id: {
2905
2963
  title: "Document Id",
2906
2964
  type: "string"
@@ -2982,6 +3040,18 @@ var output_schemas_default = {
2982
3040
  title: "Route Label",
2983
3041
  type: "string"
2984
3042
  },
3043
+ sender_name: {
3044
+ anyOf: [
3045
+ {
3046
+ type: "string"
3047
+ },
3048
+ {
3049
+ type: "null"
3050
+ }
3051
+ ],
3052
+ default: null,
3053
+ title: "Sender Name"
3054
+ },
2985
3055
  to: {
2986
3056
  title: "To",
2987
3057
  type: "string"
@@ -3730,6 +3800,11 @@ var output_schemas_default = {
3730
3800
  title: "Currency",
3731
3801
  type: "string"
3732
3802
  },
3803
+ delete_after_send: {
3804
+ default: false,
3805
+ title: "Delete After Send",
3806
+ type: "boolean"
3807
+ },
3733
3808
  direction: {
3734
3809
  title: "Direction",
3735
3810
  type: "string"
@@ -3830,6 +3905,18 @@ var output_schemas_default = {
3830
3905
  title: "Route",
3831
3906
  type: "string"
3832
3907
  },
3908
+ sender_name: {
3909
+ anyOf: [
3910
+ {
3911
+ type: "string"
3912
+ },
3913
+ {
3914
+ type: "null"
3915
+ }
3916
+ ],
3917
+ default: null,
3918
+ title: "Sender Name"
3919
+ },
3833
3920
  state: {
3834
3921
  enum: [
3835
3922
  "queued",
@@ -4393,11 +4480,43 @@ var tool_definitions_default = {
4393
4480
  }
4394
4481
  ],
4395
4482
  default: null,
4396
- description: "Fax resolution. standard is 204 by 98 dpi, fine 204 by 196 (the default when omitted), superfine 204 by 392; ultra asks the carrier for its best text setting and takes longer. Same price at every level. Pick superfine or ultra for small print or forms that must stay legible.",
4483
+ description: "Fax resolution. standard is 204 by 98 dpi, fine 204 by 196 (the default when omitted), superfine 204 by 392. ultra is the carrier's darkest text processing at superfine resolution (measured 2026-11-09: 204 by 391 dpi received) and takes longer. Same price at every level. Pick superfine for small print or forms; ultra when thin or faint print must come out black.",
4397
4484
  examples: [
4398
4485
  "superfine"
4399
4486
  ],
4400
4487
  title: "Quality"
4488
+ },
4489
+ sender_name: {
4490
+ anyOf: [
4491
+ {
4492
+ type: "string"
4493
+ },
4494
+ {
4495
+ type: "null"
4496
+ }
4497
+ ],
4498
+ default: null,
4499
+ description: "Station name the carrier prints in the fax header next to the sending number. Letters, digits, spaces and - _ ~ ! . + only, at most 128 characters. Defaults to null, which shows the number alone.",
4500
+ examples: [
4501
+ "Acme Records"
4502
+ ],
4503
+ title: "Sender Name"
4504
+ },
4505
+ delete_after_send: {
4506
+ anyOf: [
4507
+ {
4508
+ type: "boolean"
4509
+ },
4510
+ {
4511
+ type: "null"
4512
+ }
4513
+ ],
4514
+ default: null,
4515
+ description: "true deletes the document and the transmitted copy the moment the fax ends in delivered, partial or failed. The job, the receipt and the carrier evidence stay. Defaults to false: the document is kept for the retention period.",
4516
+ examples: [
4517
+ true
4518
+ ],
4519
+ title: "Delete After Send"
4401
4520
  }
4402
4521
  },
4403
4522
  required: [
@@ -5348,13 +5467,29 @@ function createServer(opts = {}) {
5348
5467
  to: z3.string(),
5349
5468
  cover: z3.record(z3.string(), z3.string()).nullable().optional(),
5350
5469
  quality: z3.enum(["standard", "fine", "superfine", "ultra"]).optional().describe(
5351
- "Fax resolution. standard is 204 by 98 dpi, fine 204 by 196 (the default when omitted), superfine 204 by 392; ultra asks the carrier for its best text setting and takes longer. Same price at every level."
5470
+ "Fax resolution. standard is 204 by 98 dpi, fine 204 by 196 (the default when omitted), superfine 204 by 392. ultra is the carrier's darkest text processing at superfine resolution (measured 2026-11-09: 204 by 391 dpi). Same price."
5471
+ ),
5472
+ sender_name: z3.string().max(128).optional().describe(
5473
+ "Station name the carrier prints in the fax header next to the sending number. Letters, digits, spaces and - _ ~ ! . + only."
5474
+ ),
5475
+ delete_after_send: z3.boolean().optional().describe(
5476
+ "true deletes the document and the transmitted copy when the fax ends. The receipt and the evidence stay."
5352
5477
  )
5353
5478
  }
5354
5479
  },
5355
- async ({ document_id, to, cover, quality }) => run(async (api) => {
5480
+ async ({
5481
+ document_id,
5482
+ to,
5483
+ cover,
5484
+ quality,
5485
+ sender_name,
5486
+ delete_after_send
5487
+ }) => run(async (api) => {
5356
5488
  const body = { document_id, to, cover };
5357
5489
  if (quality) body.quality = quality;
5490
+ if (sender_name) body.sender_name = sender_name;
5491
+ if (delete_after_send !== void 0)
5492
+ body.delete_after_send = delete_after_send;
5358
5493
  const q = await api.request("POST", "/v1/fax-quotes", { json: body });
5359
5494
  const policy = quotePolicy(q);
5360
5495
  const denied = policy.decision === "deny" && policy.policy_id ? ` Policy ${String(policy.policy_name)} denies it by rule ${String(policy.rule)}: ${String(policy.reason)}.` : "";
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "faxforagents-mcp",
3
3
  "mcpName": "io.github.faxforagents/faxforagents-mcp",
4
- "version": "0.4.2",
4
+ "version": "0.4.3",
5
5
  "description": "MCP server for Fax for Agents: let Claude, Cursor, Codex and other agents send and receive faxes through the Fax for Agents API, with quotes, human review, delegated policies, delivery evidence, guide resources and prompts.",
6
6
  "keywords": [
7
7
  "mcp",