faxforagents-mcp 0.5.3 → 0.5.4

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,24 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.5.4 (2026-11-15)
4
+
5
+ The stdio server follows the hosted server at API 1.20.6. Tool names, inputs, descriptions and the guide did not change. The output schemas did.
6
+
7
+ The output schemas name the fields the API added at 1.20.6. The handlers pass the API's objects through, so the fields reach a client as they are.
8
+
9
+ - `get_fax_balance`: `balance.held_jobs`, the fax jobs whose hold is still in place.
10
+ - `quote_fax`: `quote.route_paused`, true while an operator has paused sends on the route.
11
+ - `prepare_fax` and `get_fax_document`: `document.converted_from`, the name of an image that became the PDF, and `document.received`, the received fax the document came from.
12
+ - `request_human_review` and `get_review_status`: `document`, `requested_by_name` and `decided_by_name` on the review request.
13
+ - `get_fax_capabilities`: `default_scopes` and `admin_scopes`.
14
+ - `send_approved_fax`, `get_fax_status`, `list_faxes`, `cancel_fax` and `get_card_payment_status`: six receipt fields of a one-time order on `one_time`.
15
+
16
+ Every new field is optional. 0.5.3 differed from the hosted tool list in 48 places of the output schemas, and 0.5.4 differs in none.
17
+
18
+ The tool list was taken from the hosted server's `tools/list` on 2026-11-15, when it reported version 1.20.7.
19
+ The list equals the definitions `scripts/import-hosted.py` imported from the product source at v1.20.6.
20
+ `llms-install.md` writes the hosted address as `https://mcp.faxforagents.com/mcp/` and no longer says to keep the trailing slash. Both forms answer the same.
21
+
3
22
  ## 0.5.3 (2026-11-14)
4
23
 
5
24
  The stdio server follows the hosted server at API 1.20.5.
package/README.md CHANGED
@@ -281,7 +281,7 @@ Resource IDs require the correct prefix and exactly 32 lowercase hexadecimal cha
281
281
  Well-formed unknown IDs reach the REST API and return `not_found`.
282
282
  Protocol errors, such as a non-object arguments container, remain JSON-RPC errors.
283
283
  Tests use hosted responses recorded on 2026-11-02 and a local fake REST API. They need no hosted credentials.
284
- The tool snapshot is the hosted server's `tools/list` of 2026-11-14 at API 1.20.5. Normal tests never contact the hosted server.
284
+ The tool snapshot is the hosted server's `tools/list` of 2026-11-15, with the tools of API 1.20.6. Normal tests never contact the hosted server.
285
285
  `test/hosted-unknown-arguments.json` holds what the hosted source answers for 20 calls with unknown arguments. `test/validation.mjs` compares each one.
286
286
  The server does not start when a handler's inputs differ from the tool list. `test/inputs.mjs` calls every listed input over stdio. A wrong type has to be refused and the listed example accepted. An argument a tool does not list has to be refused by name.
287
287
  To import definitions before deployment, run the following with the product checkout's Python environment.
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.5.3";
16
+ var VERSION = "0.5.4";
17
17
 
18
18
  // src/api.ts
19
19
  var DEFAULT_BASE_URL = "https://api.faxforagents.com";
@@ -691,6 +691,19 @@ var output_schemas_default = {
691
691
  default: null,
692
692
  title: "Amount Micro"
693
693
  },
694
+ authorized_at: {
695
+ anyOf: [
696
+ {
697
+ type: "string"
698
+ },
699
+ {
700
+ type: "null"
701
+ }
702
+ ],
703
+ default: null,
704
+ description: "On a receipt: when the card was held.",
705
+ title: "Authorized At"
706
+ },
694
707
  captured_micro: {
695
708
  anyOf: [
696
709
  {
@@ -727,10 +740,52 @@ var output_schemas_default = {
727
740
  description: "The pages of the order's document. The cover sheet is not counted.",
728
741
  title: "Document Pages"
729
742
  },
743
+ email: {
744
+ anyOf: [
745
+ {
746
+ type: "string"
747
+ },
748
+ {
749
+ type: "null"
750
+ }
751
+ ],
752
+ default: null,
753
+ description: "On a receipt: the address the order was made with.",
754
+ title: "Email"
755
+ },
756
+ failure_code: {
757
+ anyOf: [
758
+ {
759
+ type: "string"
760
+ },
761
+ {
762
+ type: "null"
763
+ }
764
+ ],
765
+ default: null,
766
+ description: "On a receipt: why the order ended unpaid.",
767
+ title: "Failure Code"
768
+ },
730
769
  order_id: {
731
770
  title: "Order Id",
732
771
  type: "string"
733
772
  },
773
+ price: {
774
+ anyOf: [
775
+ {
776
+ additionalProperties: {
777
+ type: "integer"
778
+ },
779
+ type: "object"
780
+ },
781
+ {
782
+ type: "null"
783
+ }
784
+ ],
785
+ default: null,
786
+ description: "On a receipt: flat_micro, included_pages and extra_page_micro the amount follows from.",
787
+ title: "Price"
788
+ },
734
789
  refunded_micro: {
735
790
  anyOf: [
736
791
  {
@@ -744,6 +799,32 @@ var output_schemas_default = {
744
799
  description: "What was refunded to the card after the charge, in micro-units.",
745
800
  title: "Refunded Micro"
746
801
  },
802
+ sender_name: {
803
+ anyOf: [
804
+ {
805
+ type: "string"
806
+ },
807
+ {
808
+ type: "null"
809
+ }
810
+ ],
811
+ default: null,
812
+ description: "On a receipt: the sender's name.",
813
+ title: "Sender Name"
814
+ },
815
+ settled_at: {
816
+ anyOf: [
817
+ {
818
+ type: "string"
819
+ },
820
+ {
821
+ type: "null"
822
+ }
823
+ ],
824
+ default: null,
825
+ description: "On a receipt: when the payment provider confirmed the charge, or the release.",
826
+ title: "Settled At"
827
+ },
747
828
  status: {
748
829
  anyOf: [
749
830
  {
@@ -1812,6 +1893,19 @@ var output_schemas_default = {
1812
1893
  default: null,
1813
1894
  title: "Amount Micro"
1814
1895
  },
1896
+ authorized_at: {
1897
+ anyOf: [
1898
+ {
1899
+ type: "string"
1900
+ },
1901
+ {
1902
+ type: "null"
1903
+ }
1904
+ ],
1905
+ default: null,
1906
+ description: "On a receipt: when the card was held.",
1907
+ title: "Authorized At"
1908
+ },
1815
1909
  captured_micro: {
1816
1910
  anyOf: [
1817
1911
  {
@@ -1848,10 +1942,52 @@ var output_schemas_default = {
1848
1942
  description: "The pages of the order's document. The cover sheet is not counted.",
1849
1943
  title: "Document Pages"
1850
1944
  },
1945
+ email: {
1946
+ anyOf: [
1947
+ {
1948
+ type: "string"
1949
+ },
1950
+ {
1951
+ type: "null"
1952
+ }
1953
+ ],
1954
+ default: null,
1955
+ description: "On a receipt: the address the order was made with.",
1956
+ title: "Email"
1957
+ },
1958
+ failure_code: {
1959
+ anyOf: [
1960
+ {
1961
+ type: "string"
1962
+ },
1963
+ {
1964
+ type: "null"
1965
+ }
1966
+ ],
1967
+ default: null,
1968
+ description: "On a receipt: why the order ended unpaid.",
1969
+ title: "Failure Code"
1970
+ },
1851
1971
  order_id: {
1852
1972
  title: "Order Id",
1853
1973
  type: "string"
1854
1974
  },
1975
+ price: {
1976
+ anyOf: [
1977
+ {
1978
+ additionalProperties: {
1979
+ type: "integer"
1980
+ },
1981
+ type: "object"
1982
+ },
1983
+ {
1984
+ type: "null"
1985
+ }
1986
+ ],
1987
+ default: null,
1988
+ description: "On a receipt: flat_micro, included_pages and extra_page_micro the amount follows from.",
1989
+ title: "Price"
1990
+ },
1855
1991
  refunded_micro: {
1856
1992
  anyOf: [
1857
1993
  {
@@ -1865,6 +2001,32 @@ var output_schemas_default = {
1865
2001
  description: "What was refunded to the card after the charge, in micro-units.",
1866
2002
  title: "Refunded Micro"
1867
2003
  },
2004
+ sender_name: {
2005
+ anyOf: [
2006
+ {
2007
+ type: "string"
2008
+ },
2009
+ {
2010
+ type: "null"
2011
+ }
2012
+ ],
2013
+ default: null,
2014
+ description: "On a receipt: the sender's name.",
2015
+ title: "Sender Name"
2016
+ },
2017
+ settled_at: {
2018
+ anyOf: [
2019
+ {
2020
+ type: "string"
2021
+ },
2022
+ {
2023
+ type: "null"
2024
+ }
2025
+ ],
2026
+ default: null,
2027
+ description: "On a receipt: when the payment provider confirmed the charge, or the release.",
2028
+ title: "Settled At"
2029
+ },
1868
2030
  status: {
1869
2031
  anyOf: [
1870
2032
  {
@@ -2063,6 +2225,12 @@ var output_schemas_default = {
2063
2225
  title: "Environment",
2064
2226
  type: "string"
2065
2227
  },
2228
+ held_jobs: {
2229
+ default: 0,
2230
+ description: "How many fax jobs still have their hold in place: queued, sending, or ended unknown and waiting for a reconcile. Their holds add up to held_micro.",
2231
+ title: "Held Jobs",
2232
+ type: "integer"
2233
+ },
2066
2234
  held_micro: {
2067
2235
  title: "Held Micro",
2068
2236
  type: "integer"
@@ -2159,10 +2327,26 @@ var output_schemas_default = {
2159
2327
  Capabilities: {
2160
2328
  additionalProperties: true,
2161
2329
  properties: {
2330
+ admin_scopes: {
2331
+ description: "The scopes that administer the organization: keys, webhooks, billing, members, policies, agents, approval decisions and number purchases. An agent's own key never carries one.",
2332
+ items: {
2333
+ type: "string"
2334
+ },
2335
+ title: "Admin Scopes",
2336
+ type: "array"
2337
+ },
2162
2338
  approvals: {
2163
2339
  title: "Approvals",
2164
2340
  type: "boolean"
2165
2341
  },
2342
+ default_scopes: {
2343
+ description: "The scopes a key gets when POST /v1/api-keys names none.",
2344
+ items: {
2345
+ type: "string"
2346
+ },
2347
+ title: "Default Scopes",
2348
+ type: "array"
2349
+ },
2166
2350
  environment: {
2167
2351
  enum: [
2168
2352
  "live",
@@ -2407,6 +2591,18 @@ var output_schemas_default = {
2407
2591
  title: "Content Type",
2408
2592
  type: "string"
2409
2593
  },
2594
+ converted_from: {
2595
+ anyOf: [
2596
+ {
2597
+ type: "string"
2598
+ },
2599
+ {
2600
+ type: "null"
2601
+ }
2602
+ ],
2603
+ default: null,
2604
+ title: "Converted From"
2605
+ },
2410
2606
  created_at: {
2411
2607
  title: "Created At",
2412
2608
  type: "string"
@@ -2453,6 +2649,17 @@ var output_schemas_default = {
2453
2649
  title: "Page Count",
2454
2650
  type: "integer"
2455
2651
  },
2652
+ received: {
2653
+ anyOf: [
2654
+ {
2655
+ $ref: "#/$defs/DocumentReceived"
2656
+ },
2657
+ {
2658
+ type: "null"
2659
+ }
2660
+ ],
2661
+ default: null
2662
+ },
2456
2663
  render_reason: {
2457
2664
  anyOf: [
2458
2665
  {
@@ -2566,6 +2773,38 @@ var output_schemas_default = {
2566
2773
  title: "DocumentPages",
2567
2774
  type: "object"
2568
2775
  },
2776
+ DocumentReceived: {
2777
+ additionalProperties: true,
2778
+ description: "The received fax a document is the file of.",
2779
+ properties: {
2780
+ from: {
2781
+ anyOf: [
2782
+ {
2783
+ type: "string"
2784
+ },
2785
+ {
2786
+ type: "null"
2787
+ }
2788
+ ],
2789
+ default: null,
2790
+ title: "From"
2791
+ },
2792
+ inbox_item_id: {
2793
+ title: "Inbox Item Id",
2794
+ type: "string"
2795
+ },
2796
+ received_at: {
2797
+ title: "Received At",
2798
+ type: "string"
2799
+ }
2800
+ },
2801
+ required: [
2802
+ "inbox_item_id",
2803
+ "received_at"
2804
+ ],
2805
+ title: "DocumentReceived",
2806
+ type: "object"
2807
+ },
2569
2808
  PagePreview: {
2570
2809
  additionalProperties: true,
2571
2810
  properties: {
@@ -3109,6 +3348,19 @@ var output_schemas_default = {
3109
3348
  default: null,
3110
3349
  title: "Amount Micro"
3111
3350
  },
3351
+ authorized_at: {
3352
+ anyOf: [
3353
+ {
3354
+ type: "string"
3355
+ },
3356
+ {
3357
+ type: "null"
3358
+ }
3359
+ ],
3360
+ default: null,
3361
+ description: "On a receipt: when the card was held.",
3362
+ title: "Authorized At"
3363
+ },
3112
3364
  captured_micro: {
3113
3365
  anyOf: [
3114
3366
  {
@@ -3145,40 +3397,22 @@ var output_schemas_default = {
3145
3397
  description: "The pages of the order's document. The cover sheet is not counted.",
3146
3398
  title: "Document Pages"
3147
3399
  },
3148
- order_id: {
3149
- title: "Order Id",
3150
- type: "string"
3151
- },
3152
- refunded_micro: {
3400
+ email: {
3153
3401
  anyOf: [
3154
3402
  {
3155
- type: "integer"
3403
+ type: "string"
3156
3404
  },
3157
3405
  {
3158
3406
  type: "null"
3159
3407
  }
3160
3408
  ],
3161
3409
  default: null,
3162
- description: "What was refunded to the card after the charge, in micro-units.",
3163
- title: "Refunded Micro"
3410
+ description: "On a receipt: the address the order was made with.",
3411
+ title: "Email"
3164
3412
  },
3165
- status: {
3413
+ failure_code: {
3166
3414
  anyOf: [
3167
3415
  {
3168
- enum: [
3169
- "draft",
3170
- "checkout_open",
3171
- "authorized",
3172
- "awaiting_confirmation",
3173
- "released",
3174
- "capturing",
3175
- "canceling",
3176
- "captured",
3177
- "released_hold",
3178
- "expired",
3179
- "refused",
3180
- "settle_failed"
3181
- ],
3182
3416
  type: "string"
3183
3417
  },
3184
3418
  {
@@ -3186,27 +3420,113 @@ var output_schemas_default = {
3186
3420
  }
3187
3421
  ],
3188
3422
  default: null,
3189
- title: "Status"
3190
- }
3191
- },
3192
- required: [
3193
- "order_id"
3194
- ],
3195
- title: "OneTimeJob",
3196
- type: "object"
3197
- }
3198
- },
3199
- additionalProperties: false,
3200
- properties: {
3201
- attempts: {
3202
- anyOf: [
3203
- {
3204
- items: {
3205
- $ref: "#/$defs/Attempt"
3206
- },
3207
- type: "array"
3423
+ description: "On a receipt: why the order ended unpaid.",
3424
+ title: "Failure Code"
3208
3425
  },
3209
- {
3426
+ order_id: {
3427
+ title: "Order Id",
3428
+ type: "string"
3429
+ },
3430
+ price: {
3431
+ anyOf: [
3432
+ {
3433
+ additionalProperties: {
3434
+ type: "integer"
3435
+ },
3436
+ type: "object"
3437
+ },
3438
+ {
3439
+ type: "null"
3440
+ }
3441
+ ],
3442
+ default: null,
3443
+ description: "On a receipt: flat_micro, included_pages and extra_page_micro the amount follows from.",
3444
+ title: "Price"
3445
+ },
3446
+ refunded_micro: {
3447
+ anyOf: [
3448
+ {
3449
+ type: "integer"
3450
+ },
3451
+ {
3452
+ type: "null"
3453
+ }
3454
+ ],
3455
+ default: null,
3456
+ description: "What was refunded to the card after the charge, in micro-units.",
3457
+ title: "Refunded Micro"
3458
+ },
3459
+ sender_name: {
3460
+ anyOf: [
3461
+ {
3462
+ type: "string"
3463
+ },
3464
+ {
3465
+ type: "null"
3466
+ }
3467
+ ],
3468
+ default: null,
3469
+ description: "On a receipt: the sender's name.",
3470
+ title: "Sender Name"
3471
+ },
3472
+ settled_at: {
3473
+ anyOf: [
3474
+ {
3475
+ type: "string"
3476
+ },
3477
+ {
3478
+ type: "null"
3479
+ }
3480
+ ],
3481
+ default: null,
3482
+ description: "On a receipt: when the payment provider confirmed the charge, or the release.",
3483
+ title: "Settled At"
3484
+ },
3485
+ status: {
3486
+ anyOf: [
3487
+ {
3488
+ enum: [
3489
+ "draft",
3490
+ "checkout_open",
3491
+ "authorized",
3492
+ "awaiting_confirmation",
3493
+ "released",
3494
+ "capturing",
3495
+ "canceling",
3496
+ "captured",
3497
+ "released_hold",
3498
+ "expired",
3499
+ "refused",
3500
+ "settle_failed"
3501
+ ],
3502
+ type: "string"
3503
+ },
3504
+ {
3505
+ type: "null"
3506
+ }
3507
+ ],
3508
+ default: null,
3509
+ title: "Status"
3510
+ }
3511
+ },
3512
+ required: [
3513
+ "order_id"
3514
+ ],
3515
+ title: "OneTimeJob",
3516
+ type: "object"
3517
+ }
3518
+ },
3519
+ additionalProperties: false,
3520
+ properties: {
3521
+ attempts: {
3522
+ anyOf: [
3523
+ {
3524
+ items: {
3525
+ $ref: "#/$defs/Attempt"
3526
+ },
3527
+ type: "array"
3528
+ },
3529
+ {
3210
3530
  type: "null"
3211
3531
  }
3212
3532
  ],
@@ -3357,6 +3677,56 @@ var output_schemas_default = {
3357
3677
  },
3358
3678
  get_review_status: {
3359
3679
  $defs: {
3680
+ ApprovalDocument: {
3681
+ additionalProperties: true,
3682
+ properties: {
3683
+ filename: {
3684
+ anyOf: [
3685
+ {
3686
+ type: "string"
3687
+ },
3688
+ {
3689
+ type: "null"
3690
+ }
3691
+ ],
3692
+ description: "The file's name; null when the document row is gone.",
3693
+ title: "Filename"
3694
+ },
3695
+ id: {
3696
+ title: "Id",
3697
+ type: "string"
3698
+ },
3699
+ page_count: {
3700
+ anyOf: [
3701
+ {
3702
+ type: "integer"
3703
+ },
3704
+ {
3705
+ type: "null"
3706
+ }
3707
+ ],
3708
+ title: "Page Count"
3709
+ },
3710
+ state: {
3711
+ description: "available: the document is the one the request binds. deleted: it was deleted. changed: its sha256 is no longer the bound one. A send with this approval is refused in the last two.",
3712
+ enum: [
3713
+ "available",
3714
+ "deleted",
3715
+ "changed"
3716
+ ],
3717
+ title: "State",
3718
+ type: "string"
3719
+ }
3720
+ },
3721
+ required: [
3722
+ "id",
3723
+ "filename",
3724
+ "page_count",
3725
+ "state"
3726
+ ],
3727
+ title: "ApprovalDocument",
3728
+ type: "object"
3729
+ },
3360
3730
  ReviewRequest: {
3361
3731
  additionalProperties: true,
3362
3732
  description: "The approval request row as request_human_review returns it: kind send (bound to a quote) or help.",
@@ -3403,6 +3773,31 @@ var output_schemas_default = {
3403
3773
  ],
3404
3774
  title: "Decided By"
3405
3775
  },
3776
+ decided_by_name: {
3777
+ anyOf: [
3778
+ {
3779
+ type: "string"
3780
+ },
3781
+ {
3782
+ type: "null"
3783
+ }
3784
+ ],
3785
+ default: null,
3786
+ description: "The decider, named the same way.",
3787
+ title: "Decided By Name"
3788
+ },
3789
+ document: {
3790
+ anyOf: [
3791
+ {
3792
+ $ref: "#/$defs/ApprovalDocument"
3793
+ },
3794
+ {
3795
+ type: "null"
3796
+ }
3797
+ ],
3798
+ default: null,
3799
+ description: "The document a send request binds (bound.document_id). null for a help request."
3800
+ },
3406
3801
  expires_at: {
3407
3802
  anyOf: [
3408
3803
  {
@@ -3489,6 +3884,19 @@ var output_schemas_default = {
3489
3884
  title: "Requested By",
3490
3885
  type: "string"
3491
3886
  },
3887
+ requested_by_name: {
3888
+ anyOf: [
3889
+ {
3890
+ type: "string"
3891
+ },
3892
+ {
3893
+ type: "null"
3894
+ }
3895
+ ],
3896
+ default: null,
3897
+ description: "The requester as people read it: the key's label, the agent's name, the connected app's name or the person's address. null when the actor has no row in the organization any more.",
3898
+ title: "Requested By Name"
3899
+ },
3492
3900
  status: {
3493
3901
  enum: [
3494
3902
  "pending",
@@ -3915,6 +4323,19 @@ var output_schemas_default = {
3915
4323
  default: null,
3916
4324
  title: "Amount Micro"
3917
4325
  },
4326
+ authorized_at: {
4327
+ anyOf: [
4328
+ {
4329
+ type: "string"
4330
+ },
4331
+ {
4332
+ type: "null"
4333
+ }
4334
+ ],
4335
+ default: null,
4336
+ description: "On a receipt: when the card was held.",
4337
+ title: "Authorized At"
4338
+ },
3918
4339
  captured_micro: {
3919
4340
  anyOf: [
3920
4341
  {
@@ -3951,10 +4372,52 @@ var output_schemas_default = {
3951
4372
  description: "The pages of the order's document. The cover sheet is not counted.",
3952
4373
  title: "Document Pages"
3953
4374
  },
4375
+ email: {
4376
+ anyOf: [
4377
+ {
4378
+ type: "string"
4379
+ },
4380
+ {
4381
+ type: "null"
4382
+ }
4383
+ ],
4384
+ default: null,
4385
+ description: "On a receipt: the address the order was made with.",
4386
+ title: "Email"
4387
+ },
4388
+ failure_code: {
4389
+ anyOf: [
4390
+ {
4391
+ type: "string"
4392
+ },
4393
+ {
4394
+ type: "null"
4395
+ }
4396
+ ],
4397
+ default: null,
4398
+ description: "On a receipt: why the order ended unpaid.",
4399
+ title: "Failure Code"
4400
+ },
3954
4401
  order_id: {
3955
4402
  title: "Order Id",
3956
4403
  type: "string"
3957
4404
  },
4405
+ price: {
4406
+ anyOf: [
4407
+ {
4408
+ additionalProperties: {
4409
+ type: "integer"
4410
+ },
4411
+ type: "object"
4412
+ },
4413
+ {
4414
+ type: "null"
4415
+ }
4416
+ ],
4417
+ default: null,
4418
+ description: "On a receipt: flat_micro, included_pages and extra_page_micro the amount follows from.",
4419
+ title: "Price"
4420
+ },
3958
4421
  refunded_micro: {
3959
4422
  anyOf: [
3960
4423
  {
@@ -3968,6 +4431,32 @@ var output_schemas_default = {
3968
4431
  description: "What was refunded to the card after the charge, in micro-units.",
3969
4432
  title: "Refunded Micro"
3970
4433
  },
4434
+ sender_name: {
4435
+ anyOf: [
4436
+ {
4437
+ type: "string"
4438
+ },
4439
+ {
4440
+ type: "null"
4441
+ }
4442
+ ],
4443
+ default: null,
4444
+ description: "On a receipt: the sender's name.",
4445
+ title: "Sender Name"
4446
+ },
4447
+ settled_at: {
4448
+ anyOf: [
4449
+ {
4450
+ type: "string"
4451
+ },
4452
+ {
4453
+ type: "null"
4454
+ }
4455
+ ],
4456
+ default: null,
4457
+ description: "On a receipt: when the payment provider confirmed the charge, or the release.",
4458
+ title: "Settled At"
4459
+ },
3971
4460
  status: {
3972
4461
  anyOf: [
3973
4462
  {
@@ -4248,6 +4737,18 @@ var output_schemas_default = {
4248
4737
  title: "Content Type",
4249
4738
  type: "string"
4250
4739
  },
4740
+ converted_from: {
4741
+ anyOf: [
4742
+ {
4743
+ type: "string"
4744
+ },
4745
+ {
4746
+ type: "null"
4747
+ }
4748
+ ],
4749
+ default: null,
4750
+ title: "Converted From"
4751
+ },
4251
4752
  created_at: {
4252
4753
  title: "Created At",
4253
4754
  type: "string"
@@ -4294,6 +4795,17 @@ var output_schemas_default = {
4294
4795
  title: "Page Count",
4295
4796
  type: "integer"
4296
4797
  },
4798
+ received: {
4799
+ anyOf: [
4800
+ {
4801
+ $ref: "#/$defs/DocumentReceived"
4802
+ },
4803
+ {
4804
+ type: "null"
4805
+ }
4806
+ ],
4807
+ default: null
4808
+ },
4297
4809
  render_reason: {
4298
4810
  anyOf: [
4299
4811
  {
@@ -4362,6 +4874,38 @@ var output_schemas_default = {
4362
4874
  ],
4363
4875
  title: "Document",
4364
4876
  type: "object"
4877
+ },
4878
+ DocumentReceived: {
4879
+ additionalProperties: true,
4880
+ description: "The received fax a document is the file of.",
4881
+ properties: {
4882
+ from: {
4883
+ anyOf: [
4884
+ {
4885
+ type: "string"
4886
+ },
4887
+ {
4888
+ type: "null"
4889
+ }
4890
+ ],
4891
+ default: null,
4892
+ title: "From"
4893
+ },
4894
+ inbox_item_id: {
4895
+ title: "Inbox Item Id",
4896
+ type: "string"
4897
+ },
4898
+ received_at: {
4899
+ title: "Received At",
4900
+ type: "string"
4901
+ }
4902
+ },
4903
+ required: [
4904
+ "inbox_item_id",
4905
+ "received_at"
4906
+ ],
4907
+ title: "DocumentReceived",
4908
+ type: "object"
4365
4909
  }
4366
4910
  },
4367
4911
  additionalProperties: false,
@@ -4565,6 +5109,12 @@ var output_schemas_default = {
4565
5109
  title: "Route Label",
4566
5110
  type: "string"
4567
5111
  },
5112
+ route_paused: {
5113
+ default: false,
5114
+ description: "An operator has paused sends on this quote's route. A fax sent now is accepted and stays queued until the route is resumed. Read when the quote is answered, not stored.",
5115
+ title: "Route Paused",
5116
+ type: "boolean"
5117
+ },
4568
5118
  sender_name: {
4569
5119
  anyOf: [
4570
5120
  {
@@ -5459,6 +6009,56 @@ var output_schemas_default = {
5459
6009
  },
5460
6010
  request_human_review: {
5461
6011
  $defs: {
6012
+ ApprovalDocument: {
6013
+ additionalProperties: true,
6014
+ properties: {
6015
+ filename: {
6016
+ anyOf: [
6017
+ {
6018
+ type: "string"
6019
+ },
6020
+ {
6021
+ type: "null"
6022
+ }
6023
+ ],
6024
+ description: "The file's name; null when the document row is gone.",
6025
+ title: "Filename"
6026
+ },
6027
+ id: {
6028
+ title: "Id",
6029
+ type: "string"
6030
+ },
6031
+ page_count: {
6032
+ anyOf: [
6033
+ {
6034
+ type: "integer"
6035
+ },
6036
+ {
6037
+ type: "null"
6038
+ }
6039
+ ],
6040
+ title: "Page Count"
6041
+ },
6042
+ state: {
6043
+ description: "available: the document is the one the request binds. deleted: it was deleted. changed: its sha256 is no longer the bound one. A send with this approval is refused in the last two.",
6044
+ enum: [
6045
+ "available",
6046
+ "deleted",
6047
+ "changed"
6048
+ ],
6049
+ title: "State",
6050
+ type: "string"
6051
+ }
6052
+ },
6053
+ required: [
6054
+ "id",
6055
+ "filename",
6056
+ "page_count",
6057
+ "state"
6058
+ ],
6059
+ title: "ApprovalDocument",
6060
+ type: "object"
6061
+ },
5462
6062
  ReviewRequest: {
5463
6063
  additionalProperties: true,
5464
6064
  description: "The approval request row as request_human_review returns it: kind send (bound to a quote) or help.",
@@ -5505,6 +6105,31 @@ var output_schemas_default = {
5505
6105
  ],
5506
6106
  title: "Decided By"
5507
6107
  },
6108
+ decided_by_name: {
6109
+ anyOf: [
6110
+ {
6111
+ type: "string"
6112
+ },
6113
+ {
6114
+ type: "null"
6115
+ }
6116
+ ],
6117
+ default: null,
6118
+ description: "The decider, named the same way.",
6119
+ title: "Decided By Name"
6120
+ },
6121
+ document: {
6122
+ anyOf: [
6123
+ {
6124
+ $ref: "#/$defs/ApprovalDocument"
6125
+ },
6126
+ {
6127
+ type: "null"
6128
+ }
6129
+ ],
6130
+ default: null,
6131
+ description: "The document a send request binds (bound.document_id). null for a help request."
6132
+ },
5508
6133
  expires_at: {
5509
6134
  anyOf: [
5510
6135
  {
@@ -5591,6 +6216,19 @@ var output_schemas_default = {
5591
6216
  title: "Requested By",
5592
6217
  type: "string"
5593
6218
  },
6219
+ requested_by_name: {
6220
+ anyOf: [
6221
+ {
6222
+ type: "string"
6223
+ },
6224
+ {
6225
+ type: "null"
6226
+ }
6227
+ ],
6228
+ default: null,
6229
+ description: "The requester as people read it: the key's label, the agent's name, the connected app's name or the person's address. null when the actor has no row in the organization any more.",
6230
+ title: "Requested By Name"
6231
+ },
5594
6232
  status: {
5595
6233
  enum: [
5596
6234
  "pending",
@@ -6004,6 +6642,19 @@ var output_schemas_default = {
6004
6642
  default: null,
6005
6643
  title: "Amount Micro"
6006
6644
  },
6645
+ authorized_at: {
6646
+ anyOf: [
6647
+ {
6648
+ type: "string"
6649
+ },
6650
+ {
6651
+ type: "null"
6652
+ }
6653
+ ],
6654
+ default: null,
6655
+ description: "On a receipt: when the card was held.",
6656
+ title: "Authorized At"
6657
+ },
6007
6658
  captured_micro: {
6008
6659
  anyOf: [
6009
6660
  {
@@ -6040,10 +6691,52 @@ var output_schemas_default = {
6040
6691
  description: "The pages of the order's document. The cover sheet is not counted.",
6041
6692
  title: "Document Pages"
6042
6693
  },
6694
+ email: {
6695
+ anyOf: [
6696
+ {
6697
+ type: "string"
6698
+ },
6699
+ {
6700
+ type: "null"
6701
+ }
6702
+ ],
6703
+ default: null,
6704
+ description: "On a receipt: the address the order was made with.",
6705
+ title: "Email"
6706
+ },
6707
+ failure_code: {
6708
+ anyOf: [
6709
+ {
6710
+ type: "string"
6711
+ },
6712
+ {
6713
+ type: "null"
6714
+ }
6715
+ ],
6716
+ default: null,
6717
+ description: "On a receipt: why the order ended unpaid.",
6718
+ title: "Failure Code"
6719
+ },
6043
6720
  order_id: {
6044
6721
  title: "Order Id",
6045
6722
  type: "string"
6046
6723
  },
6724
+ price: {
6725
+ anyOf: [
6726
+ {
6727
+ additionalProperties: {
6728
+ type: "integer"
6729
+ },
6730
+ type: "object"
6731
+ },
6732
+ {
6733
+ type: "null"
6734
+ }
6735
+ ],
6736
+ default: null,
6737
+ description: "On a receipt: flat_micro, included_pages and extra_page_micro the amount follows from.",
6738
+ title: "Price"
6739
+ },
6047
6740
  refunded_micro: {
6048
6741
  anyOf: [
6049
6742
  {
@@ -6057,6 +6750,32 @@ var output_schemas_default = {
6057
6750
  description: "What was refunded to the card after the charge, in micro-units.",
6058
6751
  title: "Refunded Micro"
6059
6752
  },
6753
+ sender_name: {
6754
+ anyOf: [
6755
+ {
6756
+ type: "string"
6757
+ },
6758
+ {
6759
+ type: "null"
6760
+ }
6761
+ ],
6762
+ default: null,
6763
+ description: "On a receipt: the sender's name.",
6764
+ title: "Sender Name"
6765
+ },
6766
+ settled_at: {
6767
+ anyOf: [
6768
+ {
6769
+ type: "string"
6770
+ },
6771
+ {
6772
+ type: "null"
6773
+ }
6774
+ ],
6775
+ default: null,
6776
+ description: "On a receipt: when the payment provider confirmed the charge, or the release.",
6777
+ title: "Settled At"
6778
+ },
6060
6779
  status: {
6061
6780
  anyOf: [
6062
6781
  {
package/llms-install.md CHANGED
@@ -30,7 +30,7 @@ build`) runs with `command: node` and `args: ["<clone>/dist/index.js"]`.
30
30
 
31
31
  ### Hosted (primary)
32
32
 
33
- Streamable HTTP at `https://mcp.faxforagents.com/mcp/` (keep the trailing slash), authenticated with
33
+ Streamable HTTP at `https://mcp.faxforagents.com/mcp/`, authenticated with
34
34
  `Authorization: Bearer ffa_test_...` or `X-API-Key: ffa_test_...` on every request.
35
35
 
36
36
  ```bash
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.5.3",
4
+ "version": "0.5.4",
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",