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 +4 -0
- package/dist/index.js +140 -5
- package/package.json +1 -1
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.
|
|
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).
|
|
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
|
|
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
|
|
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 ({
|
|
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.
|
|
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",
|