@cyanheads/secedgar-mcp-server 0.15.13 → 0.15.14

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.
Files changed (91) hide show
  1. package/AGENTS.md +8 -6
  2. package/CLAUDE.md +8 -6
  3. package/Dockerfile +3 -3
  4. package/README.md +2 -2
  5. package/changelog/0.15.x/0.15.14.md +31 -0
  6. package/dist/index.js +7 -5
  7. package/dist/index.js.map +1 -1
  8. package/dist/mcp-server/tools/definitions/company-search.tool.d.ts +2 -2
  9. package/dist/mcp-server/tools/definitions/company-search.tool.d.ts.map +1 -1
  10. package/dist/mcp-server/tools/definitions/company-search.tool.js +8 -10
  11. package/dist/mcp-server/tools/definitions/company-search.tool.js.map +1 -1
  12. package/dist/mcp-server/tools/definitions/compare-companies.tool.d.ts +2 -2
  13. package/dist/mcp-server/tools/definitions/compare-companies.tool.d.ts.map +1 -1
  14. package/dist/mcp-server/tools/definitions/compare-companies.tool.js +6 -4
  15. package/dist/mcp-server/tools/definitions/compare-companies.tool.js.map +1 -1
  16. package/dist/mcp-server/tools/definitions/dataframe-describe.tool.d.ts +1 -1
  17. package/dist/mcp-server/tools/definitions/dataframe-describe.tool.d.ts.map +1 -1
  18. package/dist/mcp-server/tools/definitions/dataframe-describe.tool.js +1 -1
  19. package/dist/mcp-server/tools/definitions/dataframe-describe.tool.js.map +1 -1
  20. package/dist/mcp-server/tools/definitions/dataframe-drop.tool.d.ts +1 -1
  21. package/dist/mcp-server/tools/definitions/dataframe-drop.tool.d.ts.map +1 -1
  22. package/dist/mcp-server/tools/definitions/dataframe-drop.tool.js +1 -1
  23. package/dist/mcp-server/tools/definitions/dataframe-drop.tool.js.map +1 -1
  24. package/dist/mcp-server/tools/definitions/dataframe-query.tool.d.ts +1 -1
  25. package/dist/mcp-server/tools/definitions/dataframe-query.tool.d.ts.map +1 -1
  26. package/dist/mcp-server/tools/definitions/dataframe-query.tool.js +1 -1
  27. package/dist/mcp-server/tools/definitions/dataframe-query.tool.js.map +1 -1
  28. package/dist/mcp-server/tools/definitions/fetch-frames.tool.d.ts +2 -2
  29. package/dist/mcp-server/tools/definitions/fetch-frames.tool.d.ts.map +1 -1
  30. package/dist/mcp-server/tools/definitions/fetch-frames.tool.js +6 -4
  31. package/dist/mcp-server/tools/definitions/fetch-frames.tool.js.map +1 -1
  32. package/dist/mcp-server/tools/definitions/find-holders.tool.d.ts +2 -2
  33. package/dist/mcp-server/tools/definitions/find-holders.tool.d.ts.map +1 -1
  34. package/dist/mcp-server/tools/definitions/find-holders.tool.js +6 -4
  35. package/dist/mcp-server/tools/definitions/find-holders.tool.js.map +1 -1
  36. package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.d.ts +2 -2
  37. package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.d.ts.map +1 -1
  38. package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.js +7 -5
  39. package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.js.map +1 -1
  40. package/dist/mcp-server/tools/definitions/get-filing.tool.d.ts +2 -2
  41. package/dist/mcp-server/tools/definitions/get-filing.tool.d.ts.map +1 -1
  42. package/dist/mcp-server/tools/definitions/get-filing.tool.js +59 -33
  43. package/dist/mcp-server/tools/definitions/get-filing.tool.js.map +1 -1
  44. package/dist/mcp-server/tools/definitions/get-financials.tool.d.ts +2 -2
  45. package/dist/mcp-server/tools/definitions/get-financials.tool.d.ts.map +1 -1
  46. package/dist/mcp-server/tools/definitions/get-financials.tool.js +11 -8
  47. package/dist/mcp-server/tools/definitions/get-financials.tool.js.map +1 -1
  48. package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.d.ts +2 -2
  49. package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.d.ts.map +1 -1
  50. package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.js +22 -20
  51. package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.js.map +1 -1
  52. package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.d.ts +2 -2
  53. package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.d.ts.map +1 -1
  54. package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.js +9 -11
  55. package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.js.map +1 -1
  56. package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.d.ts +2 -2
  57. package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.d.ts.map +1 -1
  58. package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.js +11 -12
  59. package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.js.map +1 -1
  60. package/dist/mcp-server/tools/definitions/get-material-events.tool.d.ts +2 -2
  61. package/dist/mcp-server/tools/definitions/get-material-events.tool.d.ts.map +1 -1
  62. package/dist/mcp-server/tools/definitions/get-material-events.tool.js +8 -10
  63. package/dist/mcp-server/tools/definitions/get-material-events.tool.js.map +1 -1
  64. package/dist/mcp-server/tools/definitions/get-snapshot.tool.d.ts +2 -2
  65. package/dist/mcp-server/tools/definitions/get-snapshot.tool.d.ts.map +1 -1
  66. package/dist/mcp-server/tools/definitions/get-snapshot.tool.js +6 -4
  67. package/dist/mcp-server/tools/definitions/get-snapshot.tool.js.map +1 -1
  68. package/dist/mcp-server/tools/definitions/index.d.ts +30 -35
  69. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  70. package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts +3 -8
  71. package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts.map +1 -1
  72. package/dist/mcp-server/tools/definitions/search-filings.tool.js +117 -59
  73. package/dist/mcp-server/tools/definitions/search-filings.tool.js.map +1 -1
  74. package/dist/services/edgar/call-scope.d.ts +41 -0
  75. package/dist/services/edgar/call-scope.d.ts.map +1 -0
  76. package/dist/services/edgar/call-scope.js +53 -0
  77. package/dist/services/edgar/call-scope.js.map +1 -0
  78. package/dist/services/edgar/edgar-api-service.d.ts +80 -50
  79. package/dist/services/edgar/edgar-api-service.d.ts.map +1 -1
  80. package/dist/services/edgar/edgar-api-service.js +483 -211
  81. package/dist/services/edgar/edgar-api-service.js.map +1 -1
  82. package/dist/services/edgar/filing-to-text.d.ts +53 -14
  83. package/dist/services/edgar/filing-to-text.d.ts.map +1 -1
  84. package/dist/services/edgar/filing-to-text.js +181 -33
  85. package/dist/services/edgar/filing-to-text.js.map +1 -1
  86. package/dist/services/edgar/submissions-archive.d.ts +6 -3
  87. package/dist/services/edgar/submissions-archive.d.ts.map +1 -1
  88. package/dist/services/edgar/submissions-archive.js +6 -3
  89. package/dist/services/edgar/submissions-archive.js.map +1 -1
  90. package/package.json +4 -4
  91. package/server.json +3 -3
@@ -78,8 +78,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
78
78
  }, {
79
79
  readonly reason: "sec_unreachable";
80
80
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
81
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
82
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
81
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
82
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
83
83
  readonly retryable: true;
84
84
  readonly thrownBy: "service";
85
85
  }], {
@@ -96,7 +96,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
96
96
  readonly reason: "canvas_unavailable";
97
97
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
98
98
  readonly when: "The DataCanvas service is not configured for this deployment";
99
- readonly recovery: "Set CANVAS_PROVIDER_TYPE=duckdb in the server environment to enable dataframes.";
99
+ readonly recovery: "Dataframes need the DuckDB canvas. On an npm or Docker install, set CANVAS_PROVIDER_TYPE=duckdb (the default when unset) and restart the server; the MCPB bundle ships without DuckDB, so there the data tools return their results inline and stage no dataframe.";
100
100
  }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
101
101
  fund: import("zod").ZodString;
102
102
  series_id: import("zod").ZodOptional<import("zod").ZodString>;
@@ -175,8 +175,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
175
175
  }, {
176
176
  readonly reason: "sec_unreachable";
177
177
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
178
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
179
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
178
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
179
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
180
180
  readonly retryable: true;
181
181
  readonly thrownBy: "service";
182
182
  }], {
@@ -243,8 +243,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
243
243
  }, {
244
244
  readonly reason: "sec_unreachable";
245
245
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
246
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
247
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
246
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
247
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
248
248
  readonly retryable: true;
249
249
  readonly thrownBy: "service";
250
250
  }], {
@@ -303,11 +303,6 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
303
303
  truncated: import("zod").ZodBoolean;
304
304
  }, import("zod/v4/core").$strip>>;
305
305
  }, import("zod/v4/core").$strip>, readonly [{
306
- readonly reason: "invalid_date_range";
307
- readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
308
- readonly when: "Only one of filed_after or filed_before was provided";
309
- readonly recovery: "Provide both filed_after and filed_before, or omit both to search all dates.";
310
- }, {
311
306
  readonly reason: "unresolved_ticker";
312
307
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
313
308
  readonly when: "A ticker: targeting token in the query does not resolve to a known company";
@@ -334,7 +329,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
334
329
  readonly reason: "pre2001_full_text_unscoped";
335
330
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
336
331
  readonly when: "A date range reaching before 2001-01-01 carries free-text terms with no entity scope — no pre-2001 full-text index exists, and nothing bounds a local scan";
337
- readonly recovery: "Add ticker: or cik: entity scope to the query, drop the text terms to browse by form and date, or start the range at 2001-01-01.";
332
+ readonly recovery: "Add ticker: or cik: entity scope to the query, drop the text terms and browse by form type (forms: [\"10-K\"]) and date, or, for a range that reaches 2001, start the range at 2001-01-01.";
338
333
  }, {
339
334
  readonly reason: "rate_limited";
340
335
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
@@ -345,8 +340,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
345
340
  }, {
346
341
  readonly reason: "sec_unreachable";
347
342
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
348
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
349
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
343
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
344
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
350
345
  readonly retryable: true;
351
346
  readonly thrownBy: "service";
352
347
  }], {
@@ -451,8 +446,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
451
446
  }, {
452
447
  readonly reason: "sec_unreachable";
453
448
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
454
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
455
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
449
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
450
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
456
451
  readonly retryable: true;
457
452
  readonly thrownBy: "service";
458
453
  }], {
@@ -546,8 +541,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
546
541
  }, {
547
542
  readonly reason: "sec_unreachable";
548
543
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
549
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
550
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
544
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
545
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
551
546
  readonly retryable: true;
552
547
  readonly thrownBy: "service";
553
548
  }], {
@@ -637,8 +632,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
637
632
  }, {
638
633
  readonly reason: "sec_unreachable";
639
634
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
640
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
641
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
635
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
636
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
642
637
  readonly retryable: true;
643
638
  readonly thrownBy: "service";
644
639
  }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
@@ -708,8 +703,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
708
703
  }, {
709
704
  readonly reason: "sec_unreachable";
710
705
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
711
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
712
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
706
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
707
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
713
708
  readonly retryable: true;
714
709
  readonly thrownBy: "service";
715
710
  }], {
@@ -788,8 +783,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
788
783
  }, {
789
784
  readonly reason: "sec_unreachable";
790
785
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
791
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
792
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
786
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
787
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
793
788
  readonly retryable: true;
794
789
  readonly thrownBy: "service";
795
790
  }], {
@@ -851,8 +846,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
851
846
  }, {
852
847
  readonly reason: "sec_unreachable";
853
848
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
854
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
855
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
849
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
850
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
856
851
  readonly retryable: true;
857
852
  readonly thrownBy: "service";
858
853
  }], {
@@ -944,8 +939,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
944
939
  }, {
945
940
  readonly reason: "sec_unreachable";
946
941
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
947
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
948
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
942
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
943
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
949
944
  readonly retryable: true;
950
945
  readonly thrownBy: "service";
951
946
  }], {
@@ -1033,8 +1028,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
1033
1028
  }, {
1034
1029
  readonly reason: "sec_unreachable";
1035
1030
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
1036
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
1037
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
1031
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
1032
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
1038
1033
  readonly retryable: true;
1039
1034
  readonly thrownBy: "service";
1040
1035
  }], {
@@ -1134,8 +1129,8 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
1134
1129
  }, {
1135
1130
  readonly reason: "sec_unreachable";
1136
1131
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
1137
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
1138
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
1132
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
1133
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
1139
1134
  readonly retryable: true;
1140
1135
  readonly thrownBy: "service";
1141
1136
  }], {
@@ -1206,7 +1201,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
1206
1201
  readonly reason: "canvas_unavailable";
1207
1202
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
1208
1203
  readonly when: "The DataCanvas service is not configured for this deployment";
1209
- readonly recovery: "Set CANVAS_PROVIDER_TYPE=duckdb in the server environment to enable dataframes.";
1204
+ readonly recovery: "Dataframes need the DuckDB canvas. On an npm or Docker install, set CANVAS_PROVIDER_TYPE=duckdb (the default when unset) and restart the server; the MCPB bundle ships without DuckDB, so there the data tools return their results inline and stage no dataframe.";
1210
1205
  }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
1211
1206
  sql: import("zod").ZodString;
1212
1207
  register_as: import("zod").ZodOptional<import("zod").ZodString>;
@@ -1223,7 +1218,7 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
1223
1218
  readonly reason: "canvas_unavailable";
1224
1219
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
1225
1220
  readonly when: "The DataCanvas service is not configured for this deployment";
1226
- readonly recovery: "Set CANVAS_PROVIDER_TYPE=duckdb in the server environment to enable dataframes.";
1221
+ readonly recovery: "Dataframes need the DuckDB canvas. On an npm or Docker install, set CANVAS_PROVIDER_TYPE=duckdb (the default when unset) and restart the server; the MCPB bundle ships without DuckDB, so there the data tools return their results inline and stage no dataframe.";
1227
1222
  }, {
1228
1223
  readonly reason: "system_catalog_access";
1229
1224
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA0BlE"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAqBH,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA0BlE"}
@@ -58,11 +58,6 @@ export declare const searchFilingsTool: import("@cyanheads/mcp-ts-core").ToolDef
58
58
  truncated: z.ZodBoolean;
59
59
  }, z.core.$strip>>;
60
60
  }, z.core.$strip>, readonly [{
61
- readonly reason: "invalid_date_range";
62
- readonly code: JsonRpcErrorCode.ValidationError;
63
- readonly when: "Only one of filed_after or filed_before was provided";
64
- readonly recovery: "Provide both filed_after and filed_before, or omit both to search all dates.";
65
- }, {
66
61
  readonly reason: "unresolved_ticker";
67
62
  readonly code: JsonRpcErrorCode.ValidationError;
68
63
  readonly when: "A ticker: targeting token in the query does not resolve to a known company";
@@ -89,7 +84,7 @@ export declare const searchFilingsTool: import("@cyanheads/mcp-ts-core").ToolDef
89
84
  readonly reason: "pre2001_full_text_unscoped";
90
85
  readonly code: JsonRpcErrorCode.ValidationError;
91
86
  readonly when: "A date range reaching before 2001-01-01 carries free-text terms with no entity scope — no pre-2001 full-text index exists, and nothing bounds a local scan";
92
- readonly recovery: "Add ticker: or cik: entity scope to the query, drop the text terms to browse by form and date, or start the range at 2001-01-01.";
87
+ readonly recovery: "Add ticker: or cik: entity scope to the query, drop the text terms and browse by form type (forms: [\"10-K\"]) and date, or, for a range that reaches 2001, start the range at 2001-01-01.";
93
88
  }, {
94
89
  readonly reason: "rate_limited";
95
90
  readonly code: JsonRpcErrorCode.RateLimited;
@@ -100,8 +95,8 @@ export declare const searchFilingsTool: import("@cyanheads/mcp-ts-core").ToolDef
100
95
  }, {
101
96
  readonly reason: "sec_unreachable";
102
97
  readonly code: JsonRpcErrorCode.ServiceUnavailable;
103
- readonly when: "The last of three attempts to reach SEC EDGAR got no HTTP response — the connection failed, or no response headers arrived within 15 seconds";
104
- readonly recovery: "Retry the same call in a minute — SEC EDGAR could not be reached, and nothing in the request needs to change.";
98
+ readonly when: "SEC EDGAR gave no complete, readable response — on the last attempt made (the third, or an earlier one once this call's 40-second budget for SEC failures ran out) the connection failed, no response headers arrived within 15 seconds, or the body broke off or stalled for 15 seconds, each wait capped at what was left of that budget; a 200 body was not the JSON SEC serves; or earlier SEC failures had spent that budget, so the request was never sent";
99
+ readonly recovery: "Retry the same call in a minute — SEC EDGAR did not deliver a complete, readable response, and nothing in the request needs to change.";
105
100
  readonly retryable: true;
106
101
  readonly thrownBy: "service";
107
102
  }], {
@@ -1 +1 @@
1
- {"version":3,"file":"search-filings.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-filings.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAsB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EACL,gBAAgB,EAIjB,MAAM,+BAA+B,CAAC;AAqqBvC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAipB5B,CAAC"}
1
+ {"version":3,"file":"search-filings.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-filings.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAsB,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EACL,gBAAgB,EAIjB,MAAM,+BAA+B,CAAC;AAovBvC,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+pB5B,CAAC"}