@cyanheads/secedgar-mcp-server 0.18.0 → 0.18.1
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/AGENTS.md +4 -4
- package/CLAUDE.md +4 -4
- package/README.md +3 -3
- package/changelog/0.18.x/0.18.1.md +38 -0
- package/dist/mcp-server/tools/ambiguous-matches.d.ts +54 -15
- package/dist/mcp-server/tools/ambiguous-matches.d.ts.map +1 -1
- package/dist/mcp-server/tools/ambiguous-matches.js +19 -10
- package/dist/mcp-server/tools/ambiguous-matches.js.map +1 -1
- package/dist/mcp-server/tools/definitions/company-search.tool.d.ts +8 -8
- package/dist/mcp-server/tools/definitions/company-search.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/company-search.tool.js +7 -11
- package/dist/mcp-server/tools/definitions/company-search.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/compare-companies.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/compare-companies.tool.js +9 -7
- package/dist/mcp-server/tools/definitions/compare-companies.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/find-holders.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/find-holders.tool.js +3 -2
- package/dist/mcp-server/tools/definitions/find-holders.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.js +3 -2
- package/dist/mcp-server/tools/definitions/get-beneficial-owners.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-filing.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-filing.tool.js +11 -5
- package/dist/mcp-server/tools/definitions/get-filing.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-financials.tool.js +2 -2
- package/dist/mcp-server/tools/definitions/get-financials.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.js +3 -2
- package/dist/mcp-server/tools/definitions/get-fund-holdings.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.js +2 -2
- package/dist/mcp-server/tools/definitions/get-insider-transactions.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.js +18 -12
- package/dist/mcp-server/tools/definitions/get-institutional-holdings.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-material-events.tool.d.ts +8 -8
- package/dist/mcp-server/tools/definitions/get-material-events.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-material-events.tool.js +7 -10
- package/dist/mcp-server/tools/definitions/get-material-events.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-snapshot.tool.js +2 -2
- package/dist/mcp-server/tools/definitions/get-snapshot.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +179 -179
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-filings.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-filings.tool.js +4 -3
- package/dist/mcp-server/tools/definitions/search-filings.tool.js.map +1 -1
- package/dist/services/edgar/edgar-api-service.d.ts +20 -2
- package/dist/services/edgar/edgar-api-service.d.ts.map +1 -1
- package/dist/services/edgar/edgar-api-service.js +12 -6
- package/dist/services/edgar/edgar-api-service.js.map +1 -1
- package/package.json +2 -2
- package/server.json +3 -3
|
@@ -30,168 +30,29 @@ export interface ToolDefinitionOptions extends LimitClampOptions {
|
|
|
30
30
|
* it is present, so the manifest's tool count matches the documented surface.
|
|
31
31
|
*/
|
|
32
32
|
export declare function buildToolDefinitions(options: ToolDefinitionOptions): (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
33
|
-
|
|
34
|
-
include_filings: import("zod").ZodDefault<import("zod").ZodBoolean>;
|
|
35
|
-
forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
|
|
36
|
-
filing_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
37
|
-
filed_after: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
|
|
38
|
-
filed_before: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
|
|
33
|
+
name: import("zod").ZodOptional<import("zod").ZodString>;
|
|
39
34
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
40
|
-
|
|
41
|
-
name: import("zod").ZodString;
|
|
42
|
-
tickers: import("zod").ZodArray<import("zod").ZodString>;
|
|
43
|
-
exchanges: import("zod").ZodArray<import("zod").ZodString>;
|
|
44
|
-
sic: import("zod").ZodString;
|
|
45
|
-
sic_description: import("zod").ZodString;
|
|
46
|
-
state_of_incorporation: import("zod").ZodOptional<import("zod").ZodString>;
|
|
47
|
-
fiscal_year_end: import("zod").ZodOptional<import("zod").ZodString>;
|
|
48
|
-
series_id: import("zod").ZodOptional<import("zod").ZodString>;
|
|
49
|
-
class_id: import("zod").ZodOptional<import("zod").ZodString>;
|
|
50
|
-
filings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
|
|
51
|
-
accession_number: import("zod").ZodString;
|
|
52
|
-
form: import("zod").ZodString;
|
|
53
|
-
filing_date: import("zod").ZodString;
|
|
54
|
-
report_date: import("zod").ZodOptional<import("zod").ZodString>;
|
|
55
|
-
primary_document: import("zod").ZodString;
|
|
56
|
-
description: import("zod").ZodOptional<import("zod").ZodString>;
|
|
57
|
-
}, import("zod/v4/core").$strip>>>;
|
|
58
|
-
total_filings: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
59
|
-
history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
|
|
60
|
-
dataset: import("zod").ZodOptional<import("zod").ZodObject<{
|
|
35
|
+
dataframes: import("zod").ZodArray<import("zod").ZodObject<{
|
|
61
36
|
name: import("zod").ZodString;
|
|
62
|
-
|
|
37
|
+
source_tool: import("zod").ZodString;
|
|
38
|
+
query_params: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
|
|
39
|
+
created_at: import("zod").ZodString;
|
|
63
40
|
expires_at: import("zod").ZodString;
|
|
41
|
+
row_count: import("zod").ZodNumber;
|
|
64
42
|
truncated: import("zod").ZodBoolean;
|
|
43
|
+
max_rows: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
44
|
+
column_schema: import("zod").ZodArray<import("zod").ZodObject<{
|
|
45
|
+
name: import("zod").ZodString;
|
|
46
|
+
type: import("zod").ZodString;
|
|
47
|
+
nullable: import("zod").ZodBoolean;
|
|
48
|
+
}, import("zod/v4/core").$strip>>;
|
|
65
49
|
}, import("zod/v4/core").$strip>>;
|
|
66
|
-
}, import("zod/v4/core").$strip>, readonly [{
|
|
67
|
-
readonly reason: "no_match";
|
|
68
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
69
|
-
readonly when: "No company matches the query";
|
|
70
|
-
readonly recovery: "SEC's ticker index reflects the filer's own submissions record, which can differ from the exchange-listed symbol. ETFs and mutual funds resolve only by ticker (e.g. \"VOO\"); operating companies also resolve by full legal name or 10-digit CIK.";
|
|
71
|
-
}, {
|
|
72
|
-
readonly reason: "multiple_matches";
|
|
73
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
74
|
-
readonly when: "Query is ambiguous and matches several companies";
|
|
75
|
-
readonly recovery: "Specify a ticker symbol for an exact match instead of a name fragment.";
|
|
76
|
-
}, {
|
|
77
|
-
readonly reason: "rate_limited";
|
|
78
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
79
|
-
readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
|
|
80
|
-
readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
|
|
81
|
-
readonly retryable: true;
|
|
82
|
-
readonly thrownBy: "service";
|
|
83
|
-
}, {
|
|
84
|
-
readonly reason: "sec_unreachable";
|
|
85
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
86
|
-
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";
|
|
87
|
-
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.";
|
|
88
|
-
readonly retryable: true;
|
|
89
|
-
readonly thrownBy: "service";
|
|
90
|
-
}], {
|
|
91
|
-
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
92
|
-
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
93
|
-
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
94
|
-
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
95
|
-
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
96
|
-
name: import("zod").ZodString;
|
|
97
|
-
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
98
|
-
name: import("zod").ZodString;
|
|
99
|
-
dropped: import("zod").ZodBoolean;
|
|
100
50
|
}, import("zod/v4/core").$strip>, readonly [{
|
|
101
51
|
readonly reason: "canvas_unavailable";
|
|
102
52
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
103
53
|
readonly when: "The DataCanvas service is not configured for this deployment";
|
|
104
54
|
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.";
|
|
105
55
|
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
106
|
-
concept: import("zod").ZodString;
|
|
107
|
-
taxonomy: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
108
|
-
dei: "dei";
|
|
109
|
-
"us-gaap": "us-gaap";
|
|
110
|
-
}>>;
|
|
111
|
-
period: import("zod").ZodString;
|
|
112
|
-
unit: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
113
|
-
USD: "USD";
|
|
114
|
-
"USD-per-shares": "USD-per-shares";
|
|
115
|
-
"USD/shares": "USD/shares";
|
|
116
|
-
pure: "pure";
|
|
117
|
-
shares: "shares";
|
|
118
|
-
}>>;
|
|
119
|
-
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
120
|
-
offset: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
121
|
-
sort: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
122
|
-
asc: "asc";
|
|
123
|
-
desc: "desc";
|
|
124
|
-
}>>;
|
|
125
|
-
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
126
|
-
concept: import("zod").ZodString;
|
|
127
|
-
taxonomy: import("zod").ZodString;
|
|
128
|
-
period: import("zod").ZodString;
|
|
129
|
-
unit: import("zod").ZodString;
|
|
130
|
-
label: import("zod").ZodString;
|
|
131
|
-
total_companies: import("zod").ZodNumber;
|
|
132
|
-
offset: import("zod").ZodNumber;
|
|
133
|
-
next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
134
|
-
data: import("zod").ZodArray<import("zod").ZodObject<{
|
|
135
|
-
rank: import("zod").ZodNumber;
|
|
136
|
-
company_name: import("zod").ZodString;
|
|
137
|
-
cik: import("zod").ZodString;
|
|
138
|
-
ticker: import("zod").ZodOptional<import("zod").ZodString>;
|
|
139
|
-
value: import("zod").ZodNumber;
|
|
140
|
-
location: import("zod").ZodOptional<import("zod").ZodString>;
|
|
141
|
-
period_end: import("zod").ZodString;
|
|
142
|
-
accession_number: import("zod").ZodString;
|
|
143
|
-
}, import("zod/v4/core").$strip>>;
|
|
144
|
-
dataset: import("zod").ZodOptional<import("zod").ZodObject<{
|
|
145
|
-
name: import("zod").ZodString;
|
|
146
|
-
row_count: import("zod").ZodNumber;
|
|
147
|
-
expires_at: import("zod").ZodString;
|
|
148
|
-
}, import("zod/v4/core").$strip>>;
|
|
149
|
-
unqueried_tags: import("zod").ZodArray<import("zod").ZodString>;
|
|
150
|
-
related_tags: import("zod").ZodArray<import("zod").ZodObject<{
|
|
151
|
-
tag: import("zod").ZodString;
|
|
152
|
-
note: import("zod").ZodString;
|
|
153
|
-
}, import("zod/v4/core").$strip>>;
|
|
154
|
-
value_distribution: import("zod").ZodObject<{
|
|
155
|
-
median: import("zod").ZodNumber;
|
|
156
|
-
p95: import("zod").ZodNumber;
|
|
157
|
-
max: import("zod").ZodNumber;
|
|
158
|
-
max_to_p95_ratio: import("zod").ZodNumber;
|
|
159
|
-
}, import("zod/v4/core").$strip>;
|
|
160
|
-
period_end_range: import("zod").ZodObject<{
|
|
161
|
-
min: import("zod").ZodString;
|
|
162
|
-
max: import("zod").ZodString;
|
|
163
|
-
}, import("zod/v4/core").$strip>;
|
|
164
|
-
caveats: import("zod").ZodArray<import("zod").ZodString>;
|
|
165
|
-
}, import("zod/v4/core").$strip>, readonly [{
|
|
166
|
-
readonly reason: "unknown_concept";
|
|
167
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
168
|
-
readonly when: "The concept input is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
|
|
169
|
-
readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
|
|
170
|
-
}, {
|
|
171
|
-
readonly reason: "no_data";
|
|
172
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
173
|
-
readonly when: "Concept resolves but no companies report the tag this call read for the requested period and unit";
|
|
174
|
-
readonly recovery: "Check duration vs. instant period and the unit, then query each tag the error lists in unqueried_tags — a tag has frames only for the periods filers reported it in, so another tag the concept maps to can cover a period this one lacks.";
|
|
175
|
-
}, {
|
|
176
|
-
readonly reason: "rate_limited";
|
|
177
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
178
|
-
readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
|
|
179
|
-
readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
|
|
180
|
-
readonly retryable: true;
|
|
181
|
-
readonly thrownBy: "service";
|
|
182
|
-
}, {
|
|
183
|
-
readonly reason: "sec_unreachable";
|
|
184
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
185
|
-
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";
|
|
186
|
-
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.";
|
|
187
|
-
readonly retryable: true;
|
|
188
|
-
readonly thrownBy: "service";
|
|
189
|
-
}], {
|
|
190
|
-
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
191
|
-
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
192
|
-
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
193
|
-
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
194
|
-
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
195
56
|
company: import("zod").ZodString;
|
|
196
57
|
quarter: import("zod").ZodOptional<import("zod").ZodString>;
|
|
197
58
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
@@ -312,6 +173,69 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
|
|
|
312
173
|
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
313
174
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
314
175
|
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
176
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
177
|
+
query: import("zod").ZodString;
|
|
178
|
+
include_filings: import("zod").ZodDefault<import("zod").ZodBoolean>;
|
|
179
|
+
forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
|
|
180
|
+
filing_limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
181
|
+
filed_after: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
|
|
182
|
+
filed_before: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
|
|
183
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
184
|
+
cik: import("zod").ZodString;
|
|
185
|
+
name: import("zod").ZodString;
|
|
186
|
+
tickers: import("zod").ZodArray<import("zod").ZodString>;
|
|
187
|
+
exchanges: import("zod").ZodArray<import("zod").ZodString>;
|
|
188
|
+
sic: import("zod").ZodString;
|
|
189
|
+
sic_description: import("zod").ZodString;
|
|
190
|
+
state_of_incorporation: import("zod").ZodOptional<import("zod").ZodString>;
|
|
191
|
+
fiscal_year_end: import("zod").ZodOptional<import("zod").ZodString>;
|
|
192
|
+
series_id: import("zod").ZodOptional<import("zod").ZodString>;
|
|
193
|
+
class_id: import("zod").ZodOptional<import("zod").ZodString>;
|
|
194
|
+
filings: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
|
|
195
|
+
accession_number: import("zod").ZodString;
|
|
196
|
+
form: import("zod").ZodString;
|
|
197
|
+
filing_date: import("zod").ZodString;
|
|
198
|
+
report_date: import("zod").ZodOptional<import("zod").ZodString>;
|
|
199
|
+
primary_document: import("zod").ZodString;
|
|
200
|
+
description: import("zod").ZodOptional<import("zod").ZodString>;
|
|
201
|
+
}, import("zod/v4/core").$strip>>>;
|
|
202
|
+
total_filings: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
203
|
+
history_scanned_through: import("zod").ZodOptional<import("zod").ZodString>;
|
|
204
|
+
dataset: import("zod").ZodOptional<import("zod").ZodObject<{
|
|
205
|
+
name: import("zod").ZodString;
|
|
206
|
+
row_count: import("zod").ZodNumber;
|
|
207
|
+
expires_at: import("zod").ZodString;
|
|
208
|
+
truncated: import("zod").ZodBoolean;
|
|
209
|
+
}, import("zod/v4/core").$strip>>;
|
|
210
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
211
|
+
readonly reason: "no_match";
|
|
212
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
213
|
+
readonly when: "No company matches the query";
|
|
214
|
+
readonly recovery: "SEC's ticker index reflects the filer's own submissions record, which can differ from the exchange-listed symbol. ETFs and mutual funds resolve only by ticker (e.g. \"VOO\"); operating companies also resolve by full legal name or 10-digit CIK.";
|
|
215
|
+
}, {
|
|
216
|
+
readonly reason: "ambiguous_company";
|
|
217
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
218
|
+
readonly when: "The company input resolves to multiple entities and the target is ambiguous";
|
|
219
|
+
readonly recovery: "Use a ticker symbol or 10-digit CIK from the matches list for an exact match.";
|
|
220
|
+
}, {
|
|
221
|
+
readonly reason: "rate_limited";
|
|
222
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
223
|
+
readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
|
|
224
|
+
readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
|
|
225
|
+
readonly retryable: true;
|
|
226
|
+
readonly thrownBy: "service";
|
|
227
|
+
}, {
|
|
228
|
+
readonly reason: "sec_unreachable";
|
|
229
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
230
|
+
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";
|
|
231
|
+
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.";
|
|
232
|
+
readonly retryable: true;
|
|
233
|
+
readonly thrownBy: "service";
|
|
234
|
+
}], {
|
|
235
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
236
|
+
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
237
|
+
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
238
|
+
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
315
239
|
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
316
240
|
query: import("zod").ZodOptional<import("zod").ZodUnion<readonly [import("zod").ZodLiteral<"">, import("zod").ZodString]>>;
|
|
317
241
|
forms: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
|
|
@@ -759,10 +683,10 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
|
|
|
759
683
|
readonly when: "No company matches the query";
|
|
760
684
|
readonly recovery: "Use a ticker symbol or 10-digit CIK for an exact match, or find the company with secedgar_company_search.";
|
|
761
685
|
}, {
|
|
762
|
-
readonly reason: "
|
|
763
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.
|
|
764
|
-
readonly when: "The
|
|
765
|
-
readonly recovery: "
|
|
686
|
+
readonly reason: "ambiguous_company";
|
|
687
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
688
|
+
readonly when: "The company input resolves to multiple entities and the target is ambiguous";
|
|
689
|
+
readonly recovery: "Use a ticker symbol or 10-digit CIK from the matches list for an exact match.";
|
|
766
690
|
}, {
|
|
767
691
|
readonly reason: "rate_limited";
|
|
768
692
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
@@ -1126,6 +1050,95 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
|
|
|
1126
1050
|
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
1127
1051
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
1128
1052
|
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
1053
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
1054
|
+
concept: import("zod").ZodString;
|
|
1055
|
+
taxonomy: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
1056
|
+
dei: "dei";
|
|
1057
|
+
"us-gaap": "us-gaap";
|
|
1058
|
+
}>>;
|
|
1059
|
+
period: import("zod").ZodString;
|
|
1060
|
+
unit: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
1061
|
+
USD: "USD";
|
|
1062
|
+
"USD-per-shares": "USD-per-shares";
|
|
1063
|
+
"USD/shares": "USD/shares";
|
|
1064
|
+
pure: "pure";
|
|
1065
|
+
shares: "shares";
|
|
1066
|
+
}>>;
|
|
1067
|
+
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
1068
|
+
offset: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
1069
|
+
sort: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
1070
|
+
asc: "asc";
|
|
1071
|
+
desc: "desc";
|
|
1072
|
+
}>>;
|
|
1073
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
1074
|
+
concept: import("zod").ZodString;
|
|
1075
|
+
taxonomy: import("zod").ZodString;
|
|
1076
|
+
period: import("zod").ZodString;
|
|
1077
|
+
unit: import("zod").ZodString;
|
|
1078
|
+
label: import("zod").ZodString;
|
|
1079
|
+
total_companies: import("zod").ZodNumber;
|
|
1080
|
+
offset: import("zod").ZodNumber;
|
|
1081
|
+
next_offset: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
1082
|
+
data: import("zod").ZodArray<import("zod").ZodObject<{
|
|
1083
|
+
rank: import("zod").ZodNumber;
|
|
1084
|
+
company_name: import("zod").ZodString;
|
|
1085
|
+
cik: import("zod").ZodString;
|
|
1086
|
+
ticker: import("zod").ZodOptional<import("zod").ZodString>;
|
|
1087
|
+
value: import("zod").ZodNumber;
|
|
1088
|
+
location: import("zod").ZodOptional<import("zod").ZodString>;
|
|
1089
|
+
period_end: import("zod").ZodString;
|
|
1090
|
+
accession_number: import("zod").ZodString;
|
|
1091
|
+
}, import("zod/v4/core").$strip>>;
|
|
1092
|
+
dataset: import("zod").ZodOptional<import("zod").ZodObject<{
|
|
1093
|
+
name: import("zod").ZodString;
|
|
1094
|
+
row_count: import("zod").ZodNumber;
|
|
1095
|
+
expires_at: import("zod").ZodString;
|
|
1096
|
+
}, import("zod/v4/core").$strip>>;
|
|
1097
|
+
unqueried_tags: import("zod").ZodArray<import("zod").ZodString>;
|
|
1098
|
+
related_tags: import("zod").ZodArray<import("zod").ZodObject<{
|
|
1099
|
+
tag: import("zod").ZodString;
|
|
1100
|
+
note: import("zod").ZodString;
|
|
1101
|
+
}, import("zod/v4/core").$strip>>;
|
|
1102
|
+
value_distribution: import("zod").ZodObject<{
|
|
1103
|
+
median: import("zod").ZodNumber;
|
|
1104
|
+
p95: import("zod").ZodNumber;
|
|
1105
|
+
max: import("zod").ZodNumber;
|
|
1106
|
+
max_to_p95_ratio: import("zod").ZodNumber;
|
|
1107
|
+
}, import("zod/v4/core").$strip>;
|
|
1108
|
+
period_end_range: import("zod").ZodObject<{
|
|
1109
|
+
min: import("zod").ZodString;
|
|
1110
|
+
max: import("zod").ZodString;
|
|
1111
|
+
}, import("zod/v4/core").$strip>;
|
|
1112
|
+
caveats: import("zod").ZodArray<import("zod").ZodString>;
|
|
1113
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
1114
|
+
readonly reason: "unknown_concept";
|
|
1115
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
1116
|
+
readonly when: "The concept input is neither a supported friendly name nor shaped like an XBRL tag, so no request is sent";
|
|
1117
|
+
readonly recovery: "Use a friendly name from secedgar_search_concepts or a valid raw XBRL tag.";
|
|
1118
|
+
}, {
|
|
1119
|
+
readonly reason: "no_data";
|
|
1120
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
1121
|
+
readonly when: "Concept resolves but no companies report the tag this call read for the requested period and unit";
|
|
1122
|
+
readonly recovery: "Check duration vs. instant period and the unit, then query each tag the error lists in unqueried_tags — a tag has frames only for the periods filers reported it in, so another tag the concept maps to can cover a period this one lacks.";
|
|
1123
|
+
}, {
|
|
1124
|
+
readonly reason: "rate_limited";
|
|
1125
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
|
|
1126
|
+
readonly when: "SEC is rate-limiting this server's IP — SEC answered 429, or the call was refused without being sent while the cool-down after one runs";
|
|
1127
|
+
readonly recovery: "Wait the retryAfter seconds the error carries, then retry — SEC lifts the block only once requests stop for ten minutes.";
|
|
1128
|
+
readonly retryable: true;
|
|
1129
|
+
readonly thrownBy: "service";
|
|
1130
|
+
}, {
|
|
1131
|
+
readonly reason: "sec_unreachable";
|
|
1132
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
1133
|
+
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";
|
|
1134
|
+
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.";
|
|
1135
|
+
readonly retryable: true;
|
|
1136
|
+
readonly thrownBy: "service";
|
|
1137
|
+
}], {
|
|
1138
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
1139
|
+
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
1140
|
+
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
1141
|
+
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
1129
1142
|
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
1130
1143
|
companies: import("zod").ZodArray<import("zod").ZodString>;
|
|
1131
1144
|
concepts: import("zod").ZodArray<import("zod").ZodString>;
|
|
@@ -1271,29 +1284,6 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
|
|
|
1271
1284
|
}, import("zod/v4/core").$strip>, undefined, {
|
|
1272
1285
|
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
1273
1286
|
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
1274
|
-
name: import("zod").ZodOptional<import("zod").ZodString>;
|
|
1275
|
-
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
1276
|
-
dataframes: import("zod").ZodArray<import("zod").ZodObject<{
|
|
1277
|
-
name: import("zod").ZodString;
|
|
1278
|
-
source_tool: import("zod").ZodString;
|
|
1279
|
-
query_params: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodUnknown>;
|
|
1280
|
-
created_at: import("zod").ZodString;
|
|
1281
|
-
expires_at: import("zod").ZodString;
|
|
1282
|
-
row_count: import("zod").ZodNumber;
|
|
1283
|
-
truncated: import("zod").ZodBoolean;
|
|
1284
|
-
max_rows: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
1285
|
-
column_schema: import("zod").ZodArray<import("zod").ZodObject<{
|
|
1286
|
-
name: import("zod").ZodString;
|
|
1287
|
-
type: import("zod").ZodString;
|
|
1288
|
-
nullable: import("zod").ZodBoolean;
|
|
1289
|
-
}, import("zod/v4/core").$strip>>;
|
|
1290
|
-
}, import("zod/v4/core").$strip>>;
|
|
1291
|
-
}, import("zod/v4/core").$strip>, readonly [{
|
|
1292
|
-
readonly reason: "canvas_unavailable";
|
|
1293
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
1294
|
-
readonly when: "The DataCanvas service is not configured for this deployment";
|
|
1295
|
-
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.";
|
|
1296
|
-
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
1297
1287
|
sql: import("zod").ZodString;
|
|
1298
1288
|
register_as: import("zod").ZodOptional<import("zod").ZodString>;
|
|
1299
1289
|
preview: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
@@ -1375,5 +1365,15 @@ export declare function buildToolDefinitions(options: ToolDefinitionOptions): (i
|
|
|
1375
1365
|
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
1376
1366
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
1377
1367
|
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
1378
|
-
}>)
|
|
1368
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
1369
|
+
name: import("zod").ZodString;
|
|
1370
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
1371
|
+
name: import("zod").ZodString;
|
|
1372
|
+
dropped: import("zod").ZodBoolean;
|
|
1373
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
1374
|
+
readonly reason: "canvas_unavailable";
|
|
1375
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ServiceUnavailable;
|
|
1376
|
+
readonly when: "The DataCanvas service is not configured for this deployment";
|
|
1377
|
+
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.";
|
|
1378
|
+
}], undefined>)[];
|
|
1379
1379
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAmB3E;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAmB3E;;;;GAIG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA0BlE"}
|
|
@@ -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;AAIvC,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,mCAAmC,CAAC;AA8B3C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,OAAQ,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;AAIvC,OAAO,EACL,KAAK,iBAAiB,EAGvB,MAAM,mCAAmC,CAAC;AA8B3C;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,OAAQ,CAAC;AA6uB1C,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAitB5B,CAAC;AAEH,+FAA+F;AAC/F,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAEjE"}
|
|
@@ -214,11 +214,12 @@ async function resolveEntityTargeting(query, ctx, scope) {
|
|
|
214
214
|
if (tickerMatch?.[1]) {
|
|
215
215
|
const resolved = await getEdgarApiService().resolveCik(tickerMatch[1], scope);
|
|
216
216
|
if (Array.isArray(resolved) && resolved.length > 1) {
|
|
217
|
-
|
|
218
|
-
|
|
217
|
+
// The token is `\S+`, so a fuller name with spaces cannot be retried through it.
|
|
218
|
+
const { list, showing, data } = ambiguousMatches(resolved, { singleToken: true });
|
|
219
|
+
throw validationError(`Entity targeting token 'ticker:${tickerMatch[1]}' matches multiple companies: ${list}. Retry with ticker: or cik: and one of these tickers or 10-digit CIKs.${showing}`, {
|
|
219
220
|
reason: 'ambiguous_company',
|
|
220
221
|
...ctx.recoveryFor('ambiguous_company'),
|
|
221
|
-
|
|
222
|
+
...data,
|
|
222
223
|
});
|
|
223
224
|
}
|
|
224
225
|
const match = Array.isArray(resolved) ? resolved[0] : resolved;
|