@cyanheads/finnhub-mcp-server 0.1.6 → 0.2.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 +21 -9
- package/CLAUDE.md +21 -9
- package/Dockerfile +7 -3
- package/README.md +46 -101
- package/changelog/0.2.x/0.2.0.md +35 -0
- package/changelog/0.2.x/0.2.1.md +35 -0
- package/changelog/template.md +10 -3
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +12 -2
- package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.js +16 -8
- package/dist/mcp-server/tools/definitions/get-company.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts +25 -2
- package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-earnings.tool.js +88 -42
- package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-news.tool.d.ts +16 -0
- package/dist/mcp-server/tools/definitions/get-news.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-news.tool.js +90 -34
- package/dist/mcp-server/tools/definitions/get-news.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-quote.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-quote.tool.js +4 -2
- package/dist/mcp-server/tools/definitions/get-quote.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.js +7 -6
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +93 -42
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts +2 -0
- package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-symbols.tool.js +28 -18
- package/dist/mcp-server/tools/definitions/search-symbols.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/window-page.d.ts +21 -0
- package/dist/mcp-server/tools/definitions/window-page.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/window-page.js +39 -0
- package/dist/mcp-server/tools/definitions/window-page.js.map +1 -0
- package/dist/services/finnhub/date-window.d.ts +13 -0
- package/dist/services/finnhub/date-window.d.ts.map +1 -0
- package/dist/services/finnhub/date-window.js +32 -0
- package/dist/services/finnhub/date-window.js.map +1 -0
- package/dist/services/finnhub/finnhub-service.d.ts +4 -4
- package/dist/services/finnhub/finnhub-service.d.ts.map +1 -1
- package/dist/services/finnhub/finnhub-service.js +6 -6
- package/dist/services/finnhub/finnhub-service.js.map +1 -1
- package/dist/services/finnhub/normalize-article-text.d.ts +6 -0
- package/dist/services/finnhub/normalize-article-text.d.ts.map +1 -0
- package/dist/services/finnhub/normalize-article-text.js +97 -0
- package/dist/services/finnhub/normalize-article-text.js.map +1 -0
- package/dist/services/finnhub/types.d.ts +3 -3
- package/dist/services/finnhub/types.d.ts.map +1 -1
- package/package.json +15 -11
- package/server.json +3 -3
- package/skills/finnhub-guide/SKILL.md +31 -0
|
@@ -6,18 +6,34 @@
|
|
|
6
6
|
*/
|
|
7
7
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
8
8
|
import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
|
|
9
|
+
import { escapeMarkdownInline, markdownLink } from '@cyanheads/mcp-ts-core/utils';
|
|
10
|
+
import { dateWindow } from '../../../services/finnhub/date-window.js';
|
|
9
11
|
import { getFinnhubService } from '../../../services/finnhub/finnhub-service.js';
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
12
|
+
import { normalizeArticleText } from '../../../services/finnhub/normalize-article-text.js';
|
|
13
|
+
import { pageWindow, windowPageEnrichment } from './window-page.js';
|
|
14
|
+
function isoTimestamp(seconds) {
|
|
15
|
+
return new Date(seconds * 1000).toISOString();
|
|
16
|
+
}
|
|
17
|
+
function compareText(a, b) {
|
|
18
|
+
return a < b ? -1 : a > b ? 1 : 0;
|
|
19
|
+
}
|
|
20
|
+
function articleTie(a, b) {
|
|
21
|
+
const idOrder = a.id === b.id ? 0 : (a.id ?? Infinity) - (b.id ?? Infinity);
|
|
22
|
+
return (idOrder ||
|
|
23
|
+
compareText(a.headline, b.headline) ||
|
|
24
|
+
compareText(a.url, b.url) ||
|
|
25
|
+
compareText(a.source, b.source) ||
|
|
26
|
+
compareText(a.summary ?? '', b.summary ?? '') ||
|
|
27
|
+
compareText(a.category ?? '', b.category ?? '') ||
|
|
28
|
+
compareText(a.related ?? '', b.related ?? ''));
|
|
13
29
|
}
|
|
14
30
|
/** Normalize a raw Finnhub article to the output shape (epoch → ISO). */
|
|
15
31
|
function normalizeArticle(a) {
|
|
16
32
|
return {
|
|
17
|
-
headline: a.headline,
|
|
33
|
+
headline: normalizeArticleText(a.headline),
|
|
18
34
|
source: a.source,
|
|
19
|
-
datetime:
|
|
20
|
-
summary: a.summary ?? '',
|
|
35
|
+
datetime: isoTimestamp(a.datetime),
|
|
36
|
+
summary: normalizeArticleText(a.summary ?? ''),
|
|
21
37
|
url: a.url,
|
|
22
38
|
...(a.category ? { category: a.category } : {}),
|
|
23
39
|
...(a.related ? { related: a.related } : {}),
|
|
@@ -32,13 +48,18 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
32
48
|
.describe("'company' = recent articles for one symbol over a date range (requires `symbol`). 'market' = broad headlines by `category`."),
|
|
33
49
|
symbol: z
|
|
34
50
|
.string()
|
|
51
|
+
.trim()
|
|
52
|
+
.toUpperCase()
|
|
35
53
|
.optional()
|
|
36
|
-
.describe('Required for `company` mode. US ticker. Ignored in `market` mode.'),
|
|
54
|
+
.describe('Required and nonblank for `company` mode. US ticker, trimmed and uppercased with punctuation preserved. Ignored in `market` mode.'),
|
|
37
55
|
from: z
|
|
38
56
|
.string()
|
|
39
57
|
.optional()
|
|
40
|
-
.describe('Company mode: window start (YYYY-MM-DD).
|
|
41
|
-
to: z
|
|
58
|
+
.describe('Company mode: window start (YYYY-MM-DD). Omitted or empty defaults to today − 7 days in UTC.'),
|
|
59
|
+
to: z
|
|
60
|
+
.string()
|
|
61
|
+
.optional()
|
|
62
|
+
.describe('Company mode: window end (YYYY-MM-DD). Omitted or empty defaults to today in UTC.'),
|
|
42
63
|
category: z
|
|
43
64
|
.enum(['general', 'forex', 'crypto', 'merger'])
|
|
44
65
|
.default('general')
|
|
@@ -50,16 +71,22 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
50
71
|
.max(100)
|
|
51
72
|
.default(15)
|
|
52
73
|
.describe('Max articles (1–100). Default 15 — news lists run long; keep context lean.'),
|
|
74
|
+
offset: z
|
|
75
|
+
.number()
|
|
76
|
+
.int()
|
|
77
|
+
.nonnegative()
|
|
78
|
+
.optional()
|
|
79
|
+
.describe('Company mode only. Zero-based article offset (default 0). Use nextOffset to continue. Each page refetches Finnhub, so results may shift.'),
|
|
53
80
|
}),
|
|
54
81
|
output: z.object({
|
|
55
82
|
mode: z.enum(['company', 'market']).describe('The mode used (echo of input).'),
|
|
56
83
|
articles: z
|
|
57
84
|
.array(z
|
|
58
85
|
.object({
|
|
59
|
-
headline: z.string().describe('Article headline.'),
|
|
86
|
+
headline: z.string().describe('Article headline as text.'),
|
|
60
87
|
source: z.string().describe('Publisher name.'),
|
|
61
88
|
datetime: z.string().describe('Publish time, ISO 8601.'),
|
|
62
|
-
summary: z.string().describe('Article summary (may be empty).'),
|
|
89
|
+
summary: z.string().describe('Article summary as text (may be empty).'),
|
|
63
90
|
url: z.string().describe('Link to the article.'),
|
|
64
91
|
category: z
|
|
65
92
|
.string()
|
|
@@ -71,13 +98,31 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
71
98
|
.describe('Articles, newest first.'),
|
|
72
99
|
}),
|
|
73
100
|
enrichment: {
|
|
74
|
-
|
|
75
|
-
|
|
101
|
+
...windowPageEnrichment,
|
|
102
|
+
totalCount: z.number().describe('Articles fetched from Finnhub before local paging.'),
|
|
103
|
+
truncated: z
|
|
104
|
+
.boolean()
|
|
105
|
+
.optional()
|
|
106
|
+
.describe('True when fetched articles remain after this page.'),
|
|
76
107
|
shown: z.number().optional().describe('Number of articles returned.'),
|
|
77
108
|
cap: z.number().optional().describe('The limit that was applied.'),
|
|
78
|
-
notice: z.string().optional().describe('
|
|
109
|
+
notice: z.string().optional().describe('Empty-result, upstream coverage, or paging guidance.'),
|
|
79
110
|
},
|
|
80
111
|
errors: [
|
|
112
|
+
{
|
|
113
|
+
reason: 'invalid_date',
|
|
114
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
115
|
+
when: 'A company-news date bound is not a real YYYY-MM-DD calendar date.',
|
|
116
|
+
recovery: 'Use YYYY-MM-DD for a real calendar date.',
|
|
117
|
+
thrownBy: 'service',
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
reason: 'inverted_date_window',
|
|
121
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
122
|
+
when: 'The resolved company-news start date is later than the end date.',
|
|
123
|
+
recovery: 'Choose a start date on or before the end date.',
|
|
124
|
+
thrownBy: 'service',
|
|
125
|
+
},
|
|
81
126
|
{
|
|
82
127
|
reason: 'missing_symbol',
|
|
83
128
|
code: JsonRpcErrorCode.ValidationError,
|
|
@@ -93,7 +138,8 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
93
138
|
],
|
|
94
139
|
async handler(input, ctx) {
|
|
95
140
|
const service = getFinnhubService();
|
|
96
|
-
let
|
|
141
|
+
let page;
|
|
142
|
+
let total;
|
|
97
143
|
if (input.mode === 'company') {
|
|
98
144
|
if (!input.symbol) {
|
|
99
145
|
throw ctx.fail('missing_symbol', undefined, {
|
|
@@ -101,9 +147,8 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
101
147
|
});
|
|
102
148
|
}
|
|
103
149
|
const symbol = input.symbol;
|
|
104
|
-
const
|
|
105
|
-
|
|
106
|
-
const to = input.to || isoDate(today);
|
|
150
|
+
const { from, to } = dateWindow(input, -7, 0);
|
|
151
|
+
let raw;
|
|
107
152
|
try {
|
|
108
153
|
raw = await service.companyNews(symbol, from, to, ctx);
|
|
109
154
|
}
|
|
@@ -119,25 +164,35 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
119
164
|
if (raw.length === 0) {
|
|
120
165
|
ctx.enrich.notice(`No articles for "${symbol}" between ${from} and ${to}. Widen the date range.`);
|
|
121
166
|
}
|
|
167
|
+
const rows = raw.toSorted((a, b) => b.datetime - a.datetime || articleTie(a, b));
|
|
168
|
+
const newest = rows[0];
|
|
169
|
+
const oldest = rows.at(-1);
|
|
170
|
+
page = pageWindow(rows, input, ctx, newest && oldest
|
|
171
|
+
? {
|
|
172
|
+
fetchedFrom: isoTimestamp(oldest.datetime),
|
|
173
|
+
fetchedTo: isoTimestamp(newest.datetime),
|
|
174
|
+
warning: 'Finnhub may omit articles in the requested window. Try a narrower window or an earlier to date for older articles.',
|
|
175
|
+
}
|
|
176
|
+
: undefined);
|
|
177
|
+
total = rows.length;
|
|
122
178
|
}
|
|
123
179
|
else {
|
|
124
|
-
|
|
125
|
-
|
|
180
|
+
const rows = await service.marketNews(input.category, ctx);
|
|
181
|
+
total = rows.length;
|
|
182
|
+
if (total === 0) {
|
|
126
183
|
ctx.enrich.notice(`No articles in the "${input.category}" category right now.`);
|
|
127
184
|
}
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
if (articles.length > input.limit) {
|
|
133
|
-
ctx.enrich.truncated({ shown: sliced.length, cap: input.limit });
|
|
185
|
+
ctx.enrich.total(total);
|
|
186
|
+
page = rows.toSorted((a, b) => b.datetime - a.datetime).slice(0, input.limit);
|
|
187
|
+
if (total > input.limit)
|
|
188
|
+
ctx.enrich.truncated({ shown: page.length, cap: input.limit });
|
|
134
189
|
}
|
|
135
190
|
ctx.log.info('News fetched', {
|
|
136
191
|
mode: input.mode,
|
|
137
|
-
total
|
|
138
|
-
returned:
|
|
192
|
+
total,
|
|
193
|
+
returned: page.length,
|
|
139
194
|
});
|
|
140
|
-
return { mode: input.mode, articles:
|
|
195
|
+
return { mode: input.mode, articles: page.map(normalizeArticle) };
|
|
141
196
|
},
|
|
142
197
|
format: (result) => {
|
|
143
198
|
const header = `**${result.mode} news**`;
|
|
@@ -146,12 +201,13 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
146
201
|
}
|
|
147
202
|
const lines = [header, ''];
|
|
148
203
|
for (const a of result.articles) {
|
|
149
|
-
const
|
|
150
|
-
const
|
|
151
|
-
|
|
204
|
+
const headline = a.headline ? `**${escapeMarkdownInline(a.headline)}** ` : '';
|
|
205
|
+
const tag = a.category ? ` ${escapeMarkdownInline(`[${a.category}]`)}` : '';
|
|
206
|
+
const related = a.related ? ` · related: ${escapeMarkdownInline(a.related)}` : '';
|
|
207
|
+
lines.push(`${headline}— ${escapeMarkdownInline(a.source)}, ${a.datetime}${tag}${related}`);
|
|
152
208
|
if (a.summary)
|
|
153
|
-
lines.push(a.summary);
|
|
154
|
-
lines.push(a.url);
|
|
209
|
+
lines.push('', escapeMarkdownInline(a.summary));
|
|
210
|
+
lines.push('', markdownLink(a.url, a.url));
|
|
155
211
|
lines.push('');
|
|
156
212
|
}
|
|
157
213
|
return [{ type: 'text', text: lines.join('\n').trimEnd() }];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-news.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-news.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;
|
|
1
|
+
{"version":3,"file":"get-news.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-news.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-quote.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-quote.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"get-quote.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-quote.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsKnB,CAAC"}
|
|
@@ -14,11 +14,13 @@ export const getQuote = tool('finnhub_get_quote', {
|
|
|
14
14
|
input: z.object({
|
|
15
15
|
symbol: z
|
|
16
16
|
.string()
|
|
17
|
+
.trim()
|
|
18
|
+
.toUpperCase()
|
|
17
19
|
.min(1)
|
|
18
|
-
.describe('US stock ticker (e.g., "AAPL", "MSFT"). Resolve a company name with finnhub_search_symbols first. International symbols (with an exchange suffix like ".TO") are not on the free tier and return a clear error.'),
|
|
20
|
+
.describe('US stock ticker (e.g., "AAPL", "MSFT", "BRK.B"). Trimmed and uppercased; punctuation is preserved. Resolve a company name with finnhub_search_symbols first. International symbols (with an exchange suffix like ".TO") are not on the free tier and return a clear error.'),
|
|
19
21
|
}),
|
|
20
22
|
output: z.object({
|
|
21
|
-
symbol: z.string().describe('The symbol quoted
|
|
23
|
+
symbol: z.string().describe('The symbol quoted, trimmed and uppercased.'),
|
|
22
24
|
current: z
|
|
23
25
|
.number()
|
|
24
26
|
.describe('Current price when the market is open; the most recent close when it is not — read `priceIsLive`.'),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-quote.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-quote.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,EAAE;IAChD,WAAW,EACT,0aAA0a;IAC5a,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,
|
|
1
|
+
{"version":3,"file":"get-quote.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-quote.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -23,7 +23,7 @@ export declare const getRecommendations: import("@cyanheads/mcp-ts-core").ToolDe
|
|
|
23
23
|
readonly reason: "no_coverage";
|
|
24
24
|
readonly code: JsonRpcErrorCode.NotFound;
|
|
25
25
|
readonly when: "Endpoint returned an empty array — no analyst coverage for the symbol.";
|
|
26
|
-
readonly recovery: "Verify the
|
|
26
|
+
readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.";
|
|
27
27
|
}, {
|
|
28
28
|
readonly reason: "not_us_or_paid";
|
|
29
29
|
readonly code: JsonRpcErrorCode.Forbidden;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-recommendations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"get-recommendations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuH7B,CAAC"}
|
|
@@ -13,18 +13,19 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
|
|
|
13
13
|
input: z.object({
|
|
14
14
|
symbol: z
|
|
15
15
|
.string()
|
|
16
|
+
.trim()
|
|
17
|
+
.toUpperCase()
|
|
16
18
|
.min(1)
|
|
17
|
-
.describe('US stock ticker (e.g., "AAPL"). Resolve a name with finnhub_search_symbols first.'),
|
|
19
|
+
.describe('US stock ticker (e.g., "AAPL"), trimmed and uppercased with punctuation preserved. Resolve a name with finnhub_search_symbols first.'),
|
|
18
20
|
limit: z
|
|
19
21
|
.number()
|
|
20
22
|
.int()
|
|
21
23
|
.min(1)
|
|
22
|
-
.max(24)
|
|
23
24
|
.default(12)
|
|
24
|
-
.describe('
|
|
25
|
+
.describe('Maximum months to return from available upstream history, newest first (default 12). Increasing the limit can return more rows within Finnhub’s available history.'),
|
|
25
26
|
}),
|
|
26
27
|
output: z.object({
|
|
27
|
-
symbol: z.string().describe('The symbol queried
|
|
28
|
+
symbol: z.string().describe('The symbol queried, trimmed and uppercased.'),
|
|
28
29
|
trends: z
|
|
29
30
|
.array(z
|
|
30
31
|
.object({
|
|
@@ -40,7 +41,7 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
|
|
|
40
41
|
.describe('Number of analysts with a Strong Sell rating this month.'),
|
|
41
42
|
})
|
|
42
43
|
.describe('One month of analyst recommendation counts.'))
|
|
43
|
-
.describe('Recommendation counts per month, newest first.
|
|
44
|
+
.describe('Recommendation counts per month, newest first. History depth depends on Finnhub coverage.'),
|
|
44
45
|
}),
|
|
45
46
|
enrichment: {
|
|
46
47
|
totalCount: z.number().describe('Total months available before the limit.'),
|
|
@@ -53,7 +54,7 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
|
|
|
53
54
|
reason: 'no_coverage',
|
|
54
55
|
code: JsonRpcErrorCode.NotFound,
|
|
55
56
|
when: 'Endpoint returned an empty array — no analyst coverage for the symbol.',
|
|
56
|
-
recovery: 'Verify the
|
|
57
|
+
recovery: 'Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.',
|
|
57
58
|
},
|
|
58
59
|
{
|
|
59
60
|
reason: 'not_us_or_paid',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-recommendations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,6BAA6B,EAAE;IACpE,WAAW,EACT,mRAAmR;IACrR,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,
|
|
1
|
+
{"version":3,"file":"get-recommendations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -4,6 +4,56 @@
|
|
|
4
4
|
* @module mcp-server/tools/definitions/index
|
|
5
5
|
*/
|
|
6
6
|
export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
7
|
+
symbol: import("zod").ZodString;
|
|
8
|
+
peerGrouping: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
9
|
+
industry: "industry";
|
|
10
|
+
sector: "sector";
|
|
11
|
+
subIndustry: "subIndustry";
|
|
12
|
+
}>>;
|
|
13
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
14
|
+
symbol: import("zod").ZodString;
|
|
15
|
+
profile: import("zod").ZodObject<{
|
|
16
|
+
name: import("zod").ZodString;
|
|
17
|
+
exchange: import("zod").ZodString;
|
|
18
|
+
industry: import("zod").ZodString;
|
|
19
|
+
country: import("zod").ZodString;
|
|
20
|
+
currency: import("zod").ZodString;
|
|
21
|
+
marketCapitalization: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
22
|
+
shareOutstanding: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
23
|
+
ipo: import("zod").ZodNullable<import("zod").ZodString>;
|
|
24
|
+
weburl: import("zod").ZodNullable<import("zod").ZodString>;
|
|
25
|
+
logo: import("zod").ZodNullable<import("zod").ZodString>;
|
|
26
|
+
}, import("zod/v4/core").$strip>;
|
|
27
|
+
fundamentals: import("zod").ZodObject<{
|
|
28
|
+
peTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
29
|
+
epsTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
30
|
+
week52High: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
31
|
+
week52Low: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
32
|
+
beta: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
33
|
+
dividendYieldTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
34
|
+
netProfitMarginTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
35
|
+
grossMarginTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
36
|
+
revenueGrowthTTMYoy: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
37
|
+
roeTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
38
|
+
}, import("zod/v4/core").$strip>;
|
|
39
|
+
peerGrouping: import("zod").ZodEnum<{
|
|
40
|
+
industry: "industry";
|
|
41
|
+
sector: "sector";
|
|
42
|
+
subIndustry: "subIndustry";
|
|
43
|
+
}>;
|
|
44
|
+
peers: import("zod").ZodArray<import("zod").ZodString>;
|
|
45
|
+
partial: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
|
|
46
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
47
|
+
readonly reason: "symbol_not_found";
|
|
48
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
49
|
+
readonly when: "/stock/profile2 returned an empty object for the symbol.";
|
|
50
|
+
readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack company profiles; try finnhub_get_quote for price data.";
|
|
51
|
+
}, {
|
|
52
|
+
readonly reason: "not_us_or_paid";
|
|
53
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
54
|
+
readonly when: "Upstream HTTP 403 — international or paid-only symbol.";
|
|
55
|
+
readonly recovery: "Free tier is US equities only; international symbols need a paid Finnhub plan. Try the company's US listing.";
|
|
56
|
+
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
7
57
|
mode: import("zod").ZodEnum<{
|
|
8
58
|
company: "company";
|
|
9
59
|
market: "market";
|
|
@@ -18,6 +68,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
18
68
|
merger: "merger";
|
|
19
69
|
}>>;
|
|
20
70
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
71
|
+
offset: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
21
72
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
22
73
|
mode: import("zod").ZodEnum<{
|
|
23
74
|
company: "company";
|
|
@@ -33,6 +84,18 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
33
84
|
related: import("zod").ZodOptional<import("zod").ZodString>;
|
|
34
85
|
}, import("zod/v4/core").$strip>>;
|
|
35
86
|
}, import("zod/v4/core").$strip>, readonly [{
|
|
87
|
+
readonly reason: "invalid_date";
|
|
88
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
89
|
+
readonly when: "A company-news date bound is not a real YYYY-MM-DD calendar date.";
|
|
90
|
+
readonly recovery: "Use YYYY-MM-DD for a real calendar date.";
|
|
91
|
+
readonly thrownBy: "service";
|
|
92
|
+
}, {
|
|
93
|
+
readonly reason: "inverted_date_window";
|
|
94
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
95
|
+
readonly when: "The resolved company-news start date is later than the end date.";
|
|
96
|
+
readonly recovery: "Choose a start date on or before the end date.";
|
|
97
|
+
readonly thrownBy: "service";
|
|
98
|
+
}, {
|
|
36
99
|
readonly reason: "missing_symbol";
|
|
37
100
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
38
101
|
readonly when: "mode 'company' was requested without a symbol.";
|
|
@@ -43,6 +106,9 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
43
106
|
readonly when: "Upstream HTTP 403 on the symbol.";
|
|
44
107
|
readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
|
|
45
108
|
}], {
|
|
109
|
+
readonly fetchedFrom: import("zod").ZodOptional<import("zod").ZodString>;
|
|
110
|
+
readonly fetchedTo: import("zod").ZodOptional<import("zod").ZodString>;
|
|
111
|
+
readonly nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
46
112
|
readonly totalCount: import("zod").ZodNumber;
|
|
47
113
|
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
48
114
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
@@ -51,7 +117,9 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
51
117
|
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
52
118
|
query: import("zod").ZodString;
|
|
53
119
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
120
|
+
exchange: import("zod").ZodOptional<import("zod").ZodString>;
|
|
54
121
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
122
|
+
exchange: import("zod").ZodOptional<import("zod").ZodString>;
|
|
55
123
|
results: import("zod").ZodArray<import("zod").ZodObject<{
|
|
56
124
|
symbol: import("zod").ZodString;
|
|
57
125
|
displaySymbol: import("zod").ZodString;
|
|
@@ -95,46 +163,6 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
95
163
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
96
164
|
readonly when: "Upstream HTTP 403 — international or paid-only symbol.";
|
|
97
165
|
readonly recovery: "This free Finnhub tier covers US stocks only; international symbols require a paid plan. Try the US listing of the company.";
|
|
98
|
-
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
99
|
-
symbol: import("zod").ZodString;
|
|
100
|
-
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
101
|
-
symbol: import("zod").ZodString;
|
|
102
|
-
profile: import("zod").ZodObject<{
|
|
103
|
-
name: import("zod").ZodString;
|
|
104
|
-
exchange: import("zod").ZodString;
|
|
105
|
-
industry: import("zod").ZodString;
|
|
106
|
-
country: import("zod").ZodString;
|
|
107
|
-
currency: import("zod").ZodString;
|
|
108
|
-
marketCapitalization: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
109
|
-
shareOutstanding: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
110
|
-
ipo: import("zod").ZodNullable<import("zod").ZodString>;
|
|
111
|
-
weburl: import("zod").ZodNullable<import("zod").ZodString>;
|
|
112
|
-
logo: import("zod").ZodNullable<import("zod").ZodString>;
|
|
113
|
-
}, import("zod/v4/core").$strip>;
|
|
114
|
-
fundamentals: import("zod").ZodObject<{
|
|
115
|
-
peTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
116
|
-
epsTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
117
|
-
week52High: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
118
|
-
week52Low: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
119
|
-
beta: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
120
|
-
dividendYieldTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
121
|
-
netProfitMarginTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
122
|
-
grossMarginTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
123
|
-
revenueGrowthTTMYoy: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
124
|
-
roeTTM: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
125
|
-
}, import("zod/v4/core").$strip>;
|
|
126
|
-
peers: import("zod").ZodArray<import("zod").ZodString>;
|
|
127
|
-
partial: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>;
|
|
128
|
-
}, import("zod/v4/core").$strip>, readonly [{
|
|
129
|
-
readonly reason: "symbol_not_found";
|
|
130
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
131
|
-
readonly when: "/stock/profile2 returned an empty object for the symbol.";
|
|
132
|
-
readonly recovery: "Verify the ticker, or call finnhub_search_symbols to resolve the company name first.";
|
|
133
|
-
}, {
|
|
134
|
-
readonly reason: "not_us_or_paid";
|
|
135
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
136
|
-
readonly when: "Upstream HTTP 403 — international or paid-only symbol.";
|
|
137
|
-
readonly recovery: "Free tier is US equities only; international symbols need a paid Finnhub plan. Try the company's US listing.";
|
|
138
166
|
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
139
167
|
mode: import("zod").ZodEnum<{
|
|
140
168
|
calendar: "calendar";
|
|
@@ -144,6 +172,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
144
172
|
from: import("zod").ZodOptional<import("zod").ZodString>;
|
|
145
173
|
to: import("zod").ZodOptional<import("zod").ZodString>;
|
|
146
174
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
175
|
+
offset: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
147
176
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
148
177
|
mode: import("zod").ZodEnum<{
|
|
149
178
|
calendar: "calendar";
|
|
@@ -162,8 +191,10 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
162
191
|
symbol: import("zod").ZodString;
|
|
163
192
|
date: import("zod").ZodString;
|
|
164
193
|
hour: import("zod").ZodString;
|
|
194
|
+
epsActual: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
165
195
|
epsEstimate: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
166
196
|
revenueEstimate: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
197
|
+
revenueActual: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
167
198
|
year: import("zod").ZodNumber;
|
|
168
199
|
quarter: import("zod").ZodNumber;
|
|
169
200
|
}, import("zod/v4/core").$strip>>>;
|
|
@@ -171,13 +202,33 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
171
202
|
readonly reason: "missing_symbol";
|
|
172
203
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
173
204
|
readonly when: "mode 'history' was requested without a symbol.";
|
|
174
|
-
readonly recovery: "Provide a `symbol` for history mode, or switch to mode
|
|
205
|
+
readonly recovery: "Provide a `symbol` for history mode, or switch to calendar mode for market-wide releases.";
|
|
206
|
+
}, {
|
|
207
|
+
readonly reason: "invalid_date";
|
|
208
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
209
|
+
readonly when: "A calendar bound is not a real YYYY-MM-DD date.";
|
|
210
|
+
readonly recovery: "Use YYYY-MM-DD for a real calendar date.";
|
|
211
|
+
readonly thrownBy: "service";
|
|
212
|
+
}, {
|
|
213
|
+
readonly reason: "inverted_date_window";
|
|
214
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
215
|
+
readonly when: "The resolved calendar start date is later than the end date.";
|
|
216
|
+
readonly recovery: "Choose a start date on or before the end date.";
|
|
217
|
+
readonly thrownBy: "service";
|
|
218
|
+
}, {
|
|
219
|
+
readonly reason: "calendar_limit_exceeded";
|
|
220
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
221
|
+
readonly when: "Calendar mode requested more than 100 rows per page.";
|
|
222
|
+
readonly recovery: "Use a limit of 100 or less and continue with nextOffset.";
|
|
175
223
|
}, {
|
|
176
224
|
readonly reason: "not_us_or_paid";
|
|
177
225
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
178
226
|
readonly when: "Upstream HTTP 403 on the symbol.";
|
|
179
227
|
readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
|
|
180
228
|
}], {
|
|
229
|
+
readonly fetchedFrom: import("zod").ZodOptional<import("zod").ZodString>;
|
|
230
|
+
readonly fetchedTo: import("zod").ZodOptional<import("zod").ZodString>;
|
|
231
|
+
readonly nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
181
232
|
readonly totalCount: import("zod").ZodNumber;
|
|
182
233
|
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
183
234
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
@@ -200,7 +251,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
200
251
|
readonly reason: "no_coverage";
|
|
201
252
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
202
253
|
readonly when: "Endpoint returned an empty array — no analyst coverage for the symbol.";
|
|
203
|
-
readonly recovery: "Verify the
|
|
254
|
+
readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.";
|
|
204
255
|
}, {
|
|
205
256
|
readonly reason: "not_us_or_paid";
|
|
206
257
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,eAAO,MAAM,kBAAkB
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAO9B,CAAC"}
|
|
@@ -8,7 +8,9 @@ import { z } from '@cyanheads/mcp-ts-core';
|
|
|
8
8
|
export declare const searchSymbols: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
|
|
9
9
|
query: z.ZodString;
|
|
10
10
|
limit: z.ZodDefault<z.ZodNumber>;
|
|
11
|
+
exchange: z.ZodOptional<z.ZodString>;
|
|
11
12
|
}, z.core.$strip>, z.ZodObject<{
|
|
13
|
+
exchange: z.ZodOptional<z.ZodString>;
|
|
12
14
|
results: z.ZodArray<z.ZodObject<{
|
|
13
15
|
symbol: z.ZodString;
|
|
14
16
|
displaySymbol: z.ZodString;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-symbols.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-symbols.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"search-symbols.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-symbols.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAOjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;EAmIxB,CAAC"}
|