@cyanheads/finnhub-mcp-server 0.2.0 → 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 +7 -5
- package/CLAUDE.md +7 -5
- package/README.md +15 -12
- package/changelog/0.2.x/0.2.1.md +35 -0
- package/changelog/template.md +10 -3
- package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +11 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.js +11 -5
- 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 +84 -40
- 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 +87 -33
- package/dist/mcp-server/tools/definitions/get-news.tool.js.map +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 +1 -2
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +135 -84
- 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 +10 -7
- package/server.json +3 -3
- package/skills/finnhub-guide/SKILL.md +5 -5
|
@@ -1,24 +1,24 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* @fileoverview finnhub_get_earnings — earnings in two modes. `history`: a
|
|
3
3
|
* symbol's past quarters with actual-vs-estimate surprises. `calendar`:
|
|
4
|
-
*
|
|
4
|
+
* releases in a date window, optionally filtered by symbol.
|
|
5
5
|
* Mode-consolidated because both are the same noun (earnings) from two angles.
|
|
6
6
|
* @module mcp-server/tools/definitions/get-earnings.tool
|
|
7
7
|
*/
|
|
8
8
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
9
9
|
import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
|
|
10
|
+
import { dateWindow } from '../../../services/finnhub/date-window.js';
|
|
10
11
|
import { getFinnhubService } from '../../../services/finnhub/finnhub-service.js';
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
}
|
|
12
|
+
import { pageWindow, windowPageEnrichment } from './window-page.js';
|
|
13
|
+
const CALENDAR_PAGE_LIMIT = 100;
|
|
14
|
+
const CALENDAR_UPSTREAM_CAP = 1500;
|
|
15
15
|
export const getEarnings = tool('finnhub_get_earnings', {
|
|
16
|
-
description: "Earnings data in two modes. 'history': a symbol's past quarters
|
|
16
|
+
description: "Earnings data in two modes. 'history': a symbol's past quarters with reported vs. estimated EPS and surprise; requires `symbol`. 'calendar': releases in a date window with EPS and revenue estimates and actuals where Finnhub provides them for recently reported releases. Uses `from`/`to` and optionally filters by `symbol`. Resolve a company name with finnhub_search_symbols first.",
|
|
17
17
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
18
18
|
input: z.object({
|
|
19
19
|
mode: z
|
|
20
20
|
.enum(['history', 'calendar'])
|
|
21
|
-
.describe("'history' = one symbol's past quarters with actual-vs-estimate surprises (requires `symbol`). 'calendar' =
|
|
21
|
+
.describe("'history' = one symbol's past quarters with actual-vs-estimate surprises (requires `symbol`). 'calendar' = releases in a date window, optionally filtered by `symbol` (uses `from`/`to`)."),
|
|
22
22
|
symbol: z
|
|
23
23
|
.string()
|
|
24
24
|
.trim()
|
|
@@ -28,18 +28,23 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
28
28
|
from: z
|
|
29
29
|
.string()
|
|
30
30
|
.optional()
|
|
31
|
-
.describe('Calendar mode: window start (YYYY-MM-DD).
|
|
31
|
+
.describe('Calendar mode: window start (YYYY-MM-DD). Omitted or empty defaults to today (UTC).'),
|
|
32
32
|
to: z
|
|
33
33
|
.string()
|
|
34
34
|
.optional()
|
|
35
|
-
.describe('Calendar mode: window end (YYYY-MM-DD).
|
|
35
|
+
.describe('Calendar mode: window end (YYYY-MM-DD). Omitted or empty defaults to today + 14 days (UTC).'),
|
|
36
36
|
limit: z
|
|
37
37
|
.number()
|
|
38
38
|
.int()
|
|
39
39
|
.min(1)
|
|
40
|
-
.max(100)
|
|
41
40
|
.default(50)
|
|
42
|
-
.describe(
|
|
41
|
+
.describe(`Max rows returned. Default 50. Calendar mode allows at most ${CALENDAR_PAGE_LIMIT} per page.`),
|
|
42
|
+
offset: z
|
|
43
|
+
.number()
|
|
44
|
+
.int()
|
|
45
|
+
.min(0)
|
|
46
|
+
.optional()
|
|
47
|
+
.describe('Calendar mode: zero-based offset in fetched rows. Omitted starts at the first row.'),
|
|
43
48
|
}),
|
|
44
49
|
output: z.object({
|
|
45
50
|
mode: z.enum(['history', 'calendar']).describe('The mode used (echo of input).'),
|
|
@@ -64,10 +69,11 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
64
69
|
.array(z
|
|
65
70
|
.object({
|
|
66
71
|
symbol: z.string().describe('Stock ticker.'),
|
|
67
|
-
date: z.string().describe('
|
|
72
|
+
date: z.string().describe('Report date (YYYY-MM-DD).'),
|
|
68
73
|
hour: z
|
|
69
74
|
.string()
|
|
70
|
-
.describe('"bmo" (before open) / "amc" (after close) / "" when unknown.'),
|
|
75
|
+
.describe('"bmo" (before open) / "amc" (after close) / "dmh" (during market hours) / "" when unknown.'),
|
|
76
|
+
epsActual: z.number().nullable().describe('Reported EPS. Null when unavailable.'),
|
|
71
77
|
epsEstimate: z
|
|
72
78
|
.number()
|
|
73
79
|
.nullable()
|
|
@@ -76,26 +82,54 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
76
82
|
.number()
|
|
77
83
|
.nullable()
|
|
78
84
|
.describe('Consensus revenue estimate in the reporting currency. Null when unavailable.'),
|
|
85
|
+
revenueActual: z
|
|
86
|
+
.number()
|
|
87
|
+
.nullable()
|
|
88
|
+
.describe('Reported revenue in the reporting currency. Null when unavailable.'),
|
|
79
89
|
year: z.number().describe('Fiscal year.'),
|
|
80
90
|
quarter: z.number().describe('Fiscal quarter (1–4).'),
|
|
81
91
|
})
|
|
82
|
-
.describe('One
|
|
92
|
+
.describe('One earnings release.'))
|
|
83
93
|
.optional()
|
|
84
|
-
.describe('Present in `calendar` mode
|
|
94
|
+
.describe('Present in `calendar` mode, sorted by date then symbol. Actuals can be available for recently reported releases.'),
|
|
85
95
|
}),
|
|
86
96
|
enrichment: {
|
|
87
|
-
totalCount: z.number().describe('
|
|
97
|
+
totalCount: z.number().describe('Number of rows fetched from Finnhub before local paging.'),
|
|
88
98
|
truncated: z.boolean().optional().describe('True when rows were capped at the limit.'),
|
|
89
99
|
shown: z.number().optional().describe('Number of rows returned.'),
|
|
90
100
|
cap: z.number().optional().describe('The limit that was applied.'),
|
|
91
|
-
notice: z
|
|
101
|
+
notice: z
|
|
102
|
+
.string()
|
|
103
|
+
.optional()
|
|
104
|
+
.describe('Guidance about empty windows, coverage, or continuation.'),
|
|
105
|
+
...windowPageEnrichment,
|
|
92
106
|
},
|
|
93
107
|
errors: [
|
|
94
108
|
{
|
|
95
109
|
reason: 'missing_symbol',
|
|
96
110
|
code: JsonRpcErrorCode.ValidationError,
|
|
97
111
|
when: "mode 'history' was requested without a symbol.",
|
|
98
|
-
recovery: 'Provide a `symbol` for history mode, or switch to mode
|
|
112
|
+
recovery: 'Provide a `symbol` for history mode, or switch to calendar mode for market-wide releases.',
|
|
113
|
+
},
|
|
114
|
+
{
|
|
115
|
+
reason: 'invalid_date',
|
|
116
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
117
|
+
when: 'A calendar bound is not a real YYYY-MM-DD date.',
|
|
118
|
+
recovery: 'Use YYYY-MM-DD for a real calendar date.',
|
|
119
|
+
thrownBy: 'service',
|
|
120
|
+
},
|
|
121
|
+
{
|
|
122
|
+
reason: 'inverted_date_window',
|
|
123
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
124
|
+
when: 'The resolved calendar start date is later than the end date.',
|
|
125
|
+
recovery: 'Choose a start date on or before the end date.',
|
|
126
|
+
thrownBy: 'service',
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
reason: 'calendar_limit_exceeded',
|
|
130
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
131
|
+
when: `Calendar mode requested more than ${CALENDAR_PAGE_LIMIT} rows per page.`,
|
|
132
|
+
recovery: `Use a limit of ${CALENDAR_PAGE_LIMIT} or less and continue with nextOffset.`,
|
|
99
133
|
},
|
|
100
134
|
{
|
|
101
135
|
reason: 'not_us_or_paid',
|
|
@@ -145,10 +179,10 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
145
179
|
}
|
|
146
180
|
return { mode: 'history', history: sliced };
|
|
147
181
|
}
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
const
|
|
182
|
+
if (input.limit > CALENDAR_PAGE_LIMIT) {
|
|
183
|
+
throw ctx.fail('calendar_limit_exceeded');
|
|
184
|
+
}
|
|
185
|
+
const { from, to } = dateWindow(input, 0, 14);
|
|
152
186
|
const symbol = input.symbol || undefined;
|
|
153
187
|
let raw;
|
|
154
188
|
try {
|
|
@@ -169,23 +203,36 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
169
203
|
symbol: e.symbol,
|
|
170
204
|
date: e.date,
|
|
171
205
|
hour: e.hour,
|
|
206
|
+
epsActual: e.epsActual ?? null,
|
|
172
207
|
epsEstimate: e.epsEstimate,
|
|
173
208
|
revenueEstimate: e.revenueEstimate,
|
|
209
|
+
revenueActual: e.revenueActual ?? null,
|
|
174
210
|
year: e.year,
|
|
175
211
|
quarter: e.quarter,
|
|
176
212
|
}))
|
|
177
|
-
.sort((a, b) => a.date.localeCompare(b.date)
|
|
178
|
-
|
|
179
|
-
|
|
213
|
+
.sort((a, b) => a.date.localeCompare(b.date) ||
|
|
214
|
+
a.symbol.localeCompare(b.symbol) ||
|
|
215
|
+
a.year - b.year ||
|
|
216
|
+
a.quarter - b.quarter ||
|
|
217
|
+
a.hour.localeCompare(b.hour) ||
|
|
218
|
+
JSON.stringify(a).localeCompare(JSON.stringify(b)));
|
|
219
|
+
const first = calendar[0];
|
|
220
|
+
const last = calendar.at(-1);
|
|
221
|
+
if (!first || !last) {
|
|
180
222
|
ctx.enrich.notice(symbol
|
|
181
223
|
? `No earnings releases for "${symbol}" between ${from} and ${to}. Widen the date window.`
|
|
182
224
|
: `No earnings releases between ${from} and ${to}. Widen the date window.`);
|
|
183
225
|
}
|
|
184
|
-
const
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
226
|
+
const page = pageWindow(calendar, input, ctx, first && last
|
|
227
|
+
? {
|
|
228
|
+
fetchedFrom: first.date,
|
|
229
|
+
fetchedTo: last.date,
|
|
230
|
+
...(calendar.length >= CALENDAR_UPSTREAM_CAP && {
|
|
231
|
+
warning: 'The upstream calendar reached its row ceiling and may omit releases. Narrow the window or move to an earlier end date to look for older rows.',
|
|
232
|
+
}),
|
|
233
|
+
}
|
|
234
|
+
: undefined);
|
|
235
|
+
return { mode: 'calendar', calendar: page };
|
|
189
236
|
},
|
|
190
237
|
format: (result) => {
|
|
191
238
|
const lines = [`**Earnings (${result.mode})**`];
|
|
@@ -195,24 +242,21 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
195
242
|
const surprise = q.surprisePercent == null
|
|
196
243
|
? 'n/a'
|
|
197
244
|
: `${q.surprisePercent > 0 ? '+' : ''}${q.surprisePercent.toFixed(2)}%`;
|
|
198
|
-
const actual = q.actualEPS
|
|
199
|
-
const estimate = q.estimateEPS
|
|
200
|
-
const abs = q.surprise
|
|
245
|
+
const actual = q.actualEPS ?? 'n/a';
|
|
246
|
+
const estimate = q.estimateEPS ?? 'n/a';
|
|
247
|
+
const abs = q.surprise ?? 'n/a';
|
|
201
248
|
lines.push(`- ${q.period} (FY${q.year} Q${q.quarter}): actual ${actual} vs est ${estimate} → surprise ${surprise} (${abs} abs)`);
|
|
202
249
|
}
|
|
203
250
|
}
|
|
204
251
|
if (result.calendar) {
|
|
205
|
-
lines.push('**
|
|
252
|
+
lines.push('**Earnings calendar** (by date):');
|
|
206
253
|
for (const e of result.calendar) {
|
|
207
|
-
const eps = e.epsEstimate
|
|
208
|
-
const rev = e.revenueEstimate
|
|
254
|
+
const eps = e.epsEstimate ?? 'n/a';
|
|
255
|
+
const rev = e.revenueEstimate ?? 'n/a';
|
|
209
256
|
const hour = e.hour || 'time TBD';
|
|
210
|
-
lines.push(`- ${e.date} **${e.symbol}** (FY${e.year} Q${e.quarter}, ${hour}): EPS est ${eps}, revenue est ${rev}`);
|
|
257
|
+
lines.push(`- ${e.date} **${e.symbol}** (FY${e.year} Q${e.quarter}, ${hour}): EPS est ${eps}, revenue est ${rev}, EPS actual ${e.epsActual ?? 'n/a'}, revenue actual ${e.revenueActual ?? 'n/a'}`);
|
|
211
258
|
}
|
|
212
259
|
}
|
|
213
|
-
if (lines.length === 0) {
|
|
214
|
-
lines.push('No earnings data.');
|
|
215
|
-
}
|
|
216
260
|
return [{ type: 'text', text: lines.join('\n') }];
|
|
217
261
|
},
|
|
218
262
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-earnings.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-earnings.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,
|
|
1
|
+
{"version":3,"file":"get-earnings.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-earnings.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -21,6 +21,7 @@ export declare const getNews: import("@cyanheads/mcp-ts-core").ToolDefinition<z.
|
|
|
21
21
|
merger: "merger";
|
|
22
22
|
}>>;
|
|
23
23
|
limit: z.ZodDefault<z.ZodNumber>;
|
|
24
|
+
offset: z.ZodOptional<z.ZodNumber>;
|
|
24
25
|
}, z.core.$strip>, z.ZodObject<{
|
|
25
26
|
mode: z.ZodEnum<{
|
|
26
27
|
company: "company";
|
|
@@ -36,6 +37,18 @@ export declare const getNews: import("@cyanheads/mcp-ts-core").ToolDefinition<z.
|
|
|
36
37
|
related: z.ZodOptional<z.ZodString>;
|
|
37
38
|
}, z.core.$strip>>;
|
|
38
39
|
}, z.core.$strip>, readonly [{
|
|
40
|
+
readonly reason: "invalid_date";
|
|
41
|
+
readonly code: JsonRpcErrorCode.ValidationError;
|
|
42
|
+
readonly when: "A company-news date bound is not a real YYYY-MM-DD calendar date.";
|
|
43
|
+
readonly recovery: "Use YYYY-MM-DD for a real calendar date.";
|
|
44
|
+
readonly thrownBy: "service";
|
|
45
|
+
}, {
|
|
46
|
+
readonly reason: "inverted_date_window";
|
|
47
|
+
readonly code: JsonRpcErrorCode.ValidationError;
|
|
48
|
+
readonly when: "The resolved company-news start date is later than the end date.";
|
|
49
|
+
readonly recovery: "Choose a start date on or before the end date.";
|
|
50
|
+
readonly thrownBy: "service";
|
|
51
|
+
}, {
|
|
39
52
|
readonly reason: "missing_symbol";
|
|
40
53
|
readonly code: JsonRpcErrorCode.ValidationError;
|
|
41
54
|
readonly when: "mode 'company' was requested without a symbol.";
|
|
@@ -46,6 +59,9 @@ export declare const getNews: import("@cyanheads/mcp-ts-core").ToolDefinition<z.
|
|
|
46
59
|
readonly when: "Upstream HTTP 403 on the symbol.";
|
|
47
60
|
readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
|
|
48
61
|
}], {
|
|
62
|
+
readonly fetchedFrom: z.ZodOptional<z.ZodString>;
|
|
63
|
+
readonly fetchedTo: z.ZodOptional<z.ZodString>;
|
|
64
|
+
readonly nextOffset: z.ZodOptional<z.ZodNumber>;
|
|
49
65
|
readonly totalCount: z.ZodNumber;
|
|
50
66
|
readonly truncated: z.ZodOptional<z.ZodBoolean>;
|
|
51
67
|
readonly shown: z.ZodOptional<z.ZodNumber>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-news.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-news.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;
|
|
1
|
+
{"version":3,"file":"get-news.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-news.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAkD3E,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuMlB,CAAC"}
|
|
@@ -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 } : {}),
|
|
@@ -39,8 +55,11 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
39
55
|
from: z
|
|
40
56
|
.string()
|
|
41
57
|
.optional()
|
|
42
|
-
.describe('Company mode: window start (YYYY-MM-DD).
|
|
43
|
-
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.'),
|
|
44
63
|
category: z
|
|
45
64
|
.enum(['general', 'forex', 'crypto', 'merger'])
|
|
46
65
|
.default('general')
|
|
@@ -52,16 +71,22 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
52
71
|
.max(100)
|
|
53
72
|
.default(15)
|
|
54
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.'),
|
|
55
80
|
}),
|
|
56
81
|
output: z.object({
|
|
57
82
|
mode: z.enum(['company', 'market']).describe('The mode used (echo of input).'),
|
|
58
83
|
articles: z
|
|
59
84
|
.array(z
|
|
60
85
|
.object({
|
|
61
|
-
headline: z.string().describe('Article headline.'),
|
|
86
|
+
headline: z.string().describe('Article headline as text.'),
|
|
62
87
|
source: z.string().describe('Publisher name.'),
|
|
63
88
|
datetime: z.string().describe('Publish time, ISO 8601.'),
|
|
64
|
-
summary: z.string().describe('Article summary (may be empty).'),
|
|
89
|
+
summary: z.string().describe('Article summary as text (may be empty).'),
|
|
65
90
|
url: z.string().describe('Link to the article.'),
|
|
66
91
|
category: z
|
|
67
92
|
.string()
|
|
@@ -73,13 +98,31 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
73
98
|
.describe('Articles, newest first.'),
|
|
74
99
|
}),
|
|
75
100
|
enrichment: {
|
|
76
|
-
|
|
77
|
-
|
|
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.'),
|
|
78
107
|
shown: z.number().optional().describe('Number of articles returned.'),
|
|
79
108
|
cap: z.number().optional().describe('The limit that was applied.'),
|
|
80
|
-
notice: z.string().optional().describe('
|
|
109
|
+
notice: z.string().optional().describe('Empty-result, upstream coverage, or paging guidance.'),
|
|
81
110
|
},
|
|
82
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
|
+
},
|
|
83
126
|
{
|
|
84
127
|
reason: 'missing_symbol',
|
|
85
128
|
code: JsonRpcErrorCode.ValidationError,
|
|
@@ -95,7 +138,8 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
95
138
|
],
|
|
96
139
|
async handler(input, ctx) {
|
|
97
140
|
const service = getFinnhubService();
|
|
98
|
-
let
|
|
141
|
+
let page;
|
|
142
|
+
let total;
|
|
99
143
|
if (input.mode === 'company') {
|
|
100
144
|
if (!input.symbol) {
|
|
101
145
|
throw ctx.fail('missing_symbol', undefined, {
|
|
@@ -103,9 +147,8 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
103
147
|
});
|
|
104
148
|
}
|
|
105
149
|
const symbol = input.symbol;
|
|
106
|
-
const
|
|
107
|
-
|
|
108
|
-
const to = input.to || isoDate(today);
|
|
150
|
+
const { from, to } = dateWindow(input, -7, 0);
|
|
151
|
+
let raw;
|
|
109
152
|
try {
|
|
110
153
|
raw = await service.companyNews(symbol, from, to, ctx);
|
|
111
154
|
}
|
|
@@ -121,25 +164,35 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
121
164
|
if (raw.length === 0) {
|
|
122
165
|
ctx.enrich.notice(`No articles for "${symbol}" between ${from} and ${to}. Widen the date range.`);
|
|
123
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;
|
|
124
178
|
}
|
|
125
179
|
else {
|
|
126
|
-
|
|
127
|
-
|
|
180
|
+
const rows = await service.marketNews(input.category, ctx);
|
|
181
|
+
total = rows.length;
|
|
182
|
+
if (total === 0) {
|
|
128
183
|
ctx.enrich.notice(`No articles in the "${input.category}" category right now.`);
|
|
129
184
|
}
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
if (articles.length > input.limit) {
|
|
135
|
-
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 });
|
|
136
189
|
}
|
|
137
190
|
ctx.log.info('News fetched', {
|
|
138
191
|
mode: input.mode,
|
|
139
|
-
total
|
|
140
|
-
returned:
|
|
192
|
+
total,
|
|
193
|
+
returned: page.length,
|
|
141
194
|
});
|
|
142
|
-
return { mode: input.mode, articles:
|
|
195
|
+
return { mode: input.mode, articles: page.map(normalizeArticle) };
|
|
143
196
|
},
|
|
144
197
|
format: (result) => {
|
|
145
198
|
const header = `**${result.mode} news**`;
|
|
@@ -148,12 +201,13 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
148
201
|
}
|
|
149
202
|
const lines = [header, ''];
|
|
150
203
|
for (const a of result.articles) {
|
|
151
|
-
const
|
|
152
|
-
const
|
|
153
|
-
|
|
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}`);
|
|
154
208
|
if (a.summary)
|
|
155
|
-
lines.push(a.summary);
|
|
156
|
-
lines.push(a.url);
|
|
209
|
+
lines.push('', escapeMarkdownInline(a.summary));
|
|
210
|
+
lines.push('', markdownLink(a.url, a.url));
|
|
157
211
|
lines.push('');
|
|
158
212
|
}
|
|
159
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-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"}
|
|
@@ -21,9 +21,8 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
|
|
|
21
21
|
.number()
|
|
22
22
|
.int()
|
|
23
23
|
.min(1)
|
|
24
|
-
.max(24)
|
|
25
24
|
.default(12)
|
|
26
|
-
.describe('Maximum months to return from available upstream history, newest first (
|
|
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.'),
|
|
27
26
|
}),
|
|
28
27
|
output: z.object({
|
|
29
28
|
symbol: z.string().describe('The symbol queried, trimmed and uppercased.'),
|
|
@@ -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,IAAI,EAAE;aACN,WAAW,EAAE;aACb,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,sIAAsI,CACvI;QACH,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,
|
|
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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"}
|