@cyanheads/finnhub-mcp-server 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/AGENTS.md +376 -0
  2. package/CLAUDE.md +376 -0
  3. package/Dockerfile +121 -0
  4. package/LICENSE +201 -0
  5. package/README.md +314 -0
  6. package/changelog/0.1.x/0.1.0.md +22 -0
  7. package/changelog/template.md +127 -0
  8. package/dist/config/server-config.d.ts +25 -0
  9. package/dist/config/server-config.d.ts.map +1 -0
  10. package/dist/config/server-config.js +37 -0
  11. package/dist/config/server-config.js.map +1 -0
  12. package/dist/index.d.ts +8 -0
  13. package/dist/index.d.ts.map +1 -0
  14. package/dist/index.js +21 -0
  15. package/dist/index.js.map +1 -0
  16. package/dist/mcp-server/resources/definitions/index.d.ts +12 -0
  17. package/dist/mcp-server/resources/definitions/index.d.ts.map +1 -0
  18. package/dist/mcp-server/resources/definitions/index.js +8 -0
  19. package/dist/mcp-server/resources/definitions/index.js.map +1 -0
  20. package/dist/mcp-server/resources/definitions/news-categories.resource.d.ts +16 -0
  21. package/dist/mcp-server/resources/definitions/news-categories.resource.d.ts.map +1 -0
  22. package/dist/mcp-server/resources/definitions/news-categories.resource.js +45 -0
  23. package/dist/mcp-server/resources/definitions/news-categories.resource.js.map +1 -0
  24. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +51 -0
  25. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -0
  26. package/dist/mcp-server/tools/definitions/get-company.tool.js +191 -0
  27. package/dist/mcp-server/tools/definitions/get-company.tool.js.map +1 -0
  28. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts +59 -0
  29. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts.map +1 -0
  30. package/dist/mcp-server/tools/definitions/get-earnings.tool.js +201 -0
  31. package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -0
  32. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts +55 -0
  33. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts.map +1 -0
  34. package/dist/mcp-server/tools/definitions/get-news.tool.js +160 -0
  35. package/dist/mcp-server/tools/definitions/get-news.tool.js.map +1 -0
  36. package/dist/mcp-server/tools/definitions/get-quote.tool.d.ts +35 -0
  37. package/dist/mcp-server/tools/definitions/get-quote.tool.d.ts.map +1 -0
  38. package/dist/mcp-server/tools/definitions/get-quote.tool.js +132 -0
  39. package/dist/mcp-server/tools/definitions/get-quote.tool.js.map +1 -0
  40. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts +38 -0
  41. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts.map +1 -0
  42. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js +110 -0
  43. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -0
  44. package/dist/mcp-server/tools/definitions/index.d.ts +209 -0
  45. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  46. package/dist/mcp-server/tools/definitions/index.js +20 -0
  47. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  48. package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts +26 -0
  49. package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts.map +1 -0
  50. package/dist/mcp-server/tools/definitions/search-symbols.tool.js +101 -0
  51. package/dist/mcp-server/tools/definitions/search-symbols.tool.js.map +1 -0
  52. package/dist/services/finnhub/finnhub-service.d.ts +77 -0
  53. package/dist/services/finnhub/finnhub-service.d.ts.map +1 -0
  54. package/dist/services/finnhub/finnhub-service.js +148 -0
  55. package/dist/services/finnhub/finnhub-service.js.map +1 -0
  56. package/dist/services/finnhub/types.d.ts +147 -0
  57. package/dist/services/finnhub/types.d.ts.map +1 -0
  58. package/dist/services/finnhub/types.js +9 -0
  59. package/dist/services/finnhub/types.js.map +1 -0
  60. package/package.json +85 -0
  61. package/server.json +125 -0
@@ -0,0 +1,201 @@
1
+ /**
2
+ * @fileoverview finnhub_get_earnings — earnings in two modes. `history`: a
3
+ * symbol's past quarters with actual-vs-estimate surprises. `calendar`:
4
+ * market-wide upcoming releases in a date window. Mode-consolidated because both
5
+ * are the same noun (earnings) from two angles.
6
+ * @module mcp-server/tools/definitions/get-earnings.tool
7
+ */
8
+ import { tool, z } from '@cyanheads/mcp-ts-core';
9
+ import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
10
+ import { getFinnhubService } from '../../../services/finnhub/finnhub-service.js';
11
+ /** Format a Date as YYYY-MM-DD (UTC). */
12
+ function isoDate(date) {
13
+ return date.toISOString().slice(0, 10);
14
+ }
15
+ export const getEarnings = tool('finnhub_get_earnings', {
16
+ description: "Earnings data in two modes. 'history': a symbol's past quarters — actual vs. estimate EPS, surprise %, period (the surprise is the market-moving signal, surfaced prominently); requires `symbol`. 'calendar': upcoming releases across the market in a date window — date, EPS/revenue estimates, symbol; uses `from`/`to`. Resolve a company name with finnhub_search_symbols first for history mode.",
17
+ annotations: { readOnlyHint: true, openWorldHint: true },
18
+ input: z.object({
19
+ mode: z
20
+ .enum(['history', 'calendar'])
21
+ .describe("'history' = one symbol's past quarters with actual-vs-estimate surprises (requires `symbol`). 'calendar' = market-wide upcoming releases in a date window (uses `from`/`to`)."),
22
+ symbol: z
23
+ .string()
24
+ .optional()
25
+ .describe('Required for `history`. US ticker. Resolve a name with finnhub_search_symbols first. Ignored in `calendar` mode.'),
26
+ from: z
27
+ .string()
28
+ .optional()
29
+ .describe('Calendar mode: window start (YYYY-MM-DD). Defaults to today when omitted.'),
30
+ to: z
31
+ .string()
32
+ .optional()
33
+ .describe('Calendar mode: window end (YYYY-MM-DD). Defaults to today + 14 days when omitted.'),
34
+ limit: z
35
+ .number()
36
+ .int()
37
+ .min(1)
38
+ .max(100)
39
+ .default(50)
40
+ .describe('Max rows returned (history quarters or calendar entries). Default 50.'),
41
+ }),
42
+ output: z.object({
43
+ mode: z.enum(['history', 'calendar']).describe('The mode used (echo of input).'),
44
+ history: z
45
+ .array(z
46
+ .object({
47
+ period: z.string().describe('Fiscal period end (YYYY-MM-DD).'),
48
+ year: z.number().describe('Fiscal year.'),
49
+ quarter: z.number().describe('Fiscal quarter (1–4).'),
50
+ actualEPS: z.number().nullable().describe('Reported EPS. Null if not yet reported.'),
51
+ estimateEPS: z.number().nullable().describe('Consensus estimate EPS.'),
52
+ surprise: z.number().nullable().describe('actual − estimate (absolute).'),
53
+ surprisePercent: z
54
+ .number()
55
+ .nullable()
56
+ .describe('Surprise as % of estimate — the market-moving signal. Positive = beat, negative = miss.'),
57
+ })
58
+ .describe('One past earnings quarter.'))
59
+ .optional()
60
+ .describe('Present in `history` mode. Newest quarter first.'),
61
+ calendar: z
62
+ .array(z
63
+ .object({
64
+ symbol: z.string().describe('Stock ticker.'),
65
+ date: z.string().describe('Expected report date (YYYY-MM-DD).'),
66
+ hour: z
67
+ .string()
68
+ .describe('"bmo" (before open) / "amc" (after close) / "" when unknown.'),
69
+ epsEstimate: z
70
+ .number()
71
+ .nullable()
72
+ .describe('Consensus EPS estimate. Null for distant future dates or uncovered symbols.'),
73
+ revenueEstimate: z
74
+ .number()
75
+ .nullable()
76
+ .describe('Consensus revenue estimate in the reporting currency. Null when unavailable.'),
77
+ year: z.number().describe('Fiscal year.'),
78
+ quarter: z.number().describe('Fiscal quarter (1–4).'),
79
+ })
80
+ .describe('One upcoming earnings release.'))
81
+ .optional()
82
+ .describe('Present in `calendar` mode. Sorted by date. Note: `epsActual` and `revenueActual` are not surfaced here — this tool is for the upcoming-releases workflow; actuals are available in `history` mode for a specific symbol.'),
83
+ }),
84
+ enrichment: {
85
+ totalCount: z.number().describe('Total rows available before the limit.'),
86
+ truncated: z.boolean().optional().describe('True when rows were capped at the limit.'),
87
+ shown: z.number().optional().describe('Number of rows returned.'),
88
+ cap: z.number().optional().describe('The limit that was applied.'),
89
+ notice: z.string().optional().describe('Guidance when the result set is empty.'),
90
+ },
91
+ errors: [
92
+ {
93
+ reason: 'missing_symbol',
94
+ code: JsonRpcErrorCode.InvalidParams,
95
+ when: "mode 'history' was requested without a symbol.",
96
+ recovery: 'Provide a `symbol` for history mode, or switch to mode: calendar for the market-wide upcoming-releases feed.',
97
+ },
98
+ {
99
+ reason: 'not_us_or_paid',
100
+ code: JsonRpcErrorCode.Forbidden,
101
+ when: 'Upstream HTTP 403 on the symbol.',
102
+ recovery: 'Free tier is US equities only; use a US symbol or a paid plan.',
103
+ },
104
+ ],
105
+ async handler(input, ctx) {
106
+ const service = getFinnhubService();
107
+ if (input.mode === 'history') {
108
+ if (!input.symbol) {
109
+ throw ctx.fail('missing_symbol', undefined, {
110
+ ...ctx.recoveryFor('missing_symbol'),
111
+ });
112
+ }
113
+ const symbol = input.symbol;
114
+ let raw;
115
+ try {
116
+ raw = await service.earnings(symbol, ctx);
117
+ }
118
+ catch (err) {
119
+ if (err instanceof McpError && err.code === JsonRpcErrorCode.Forbidden) {
120
+ throw ctx.fail('not_us_or_paid', undefined, {
121
+ symbol,
122
+ ...ctx.recoveryFor('not_us_or_paid'),
123
+ });
124
+ }
125
+ throw err;
126
+ }
127
+ const history = raw.map((e) => ({
128
+ period: e.period,
129
+ year: e.year,
130
+ quarter: e.quarter,
131
+ actualEPS: e.actual,
132
+ estimateEPS: e.estimate,
133
+ surprise: e.surprise,
134
+ surprisePercent: e.surprisePercent,
135
+ }));
136
+ ctx.enrich.total(history.length);
137
+ if (history.length === 0) {
138
+ ctx.enrich.notice(`No earnings history for "${symbol}". Verify the symbol with finnhub_search_symbols.`);
139
+ }
140
+ const sliced = history.slice(0, input.limit);
141
+ if (history.length > input.limit) {
142
+ ctx.enrich.truncated({ shown: sliced.length, cap: input.limit });
143
+ }
144
+ return { mode: 'history', history: sliced };
145
+ }
146
+ // calendar mode
147
+ const today = new Date();
148
+ const from = input.from || isoDate(today);
149
+ const to = input.to || isoDate(new Date(today.getTime() + 14 * 86_400_000));
150
+ const { earningsCalendar } = await service.earningsCalendar(from, to, ctx);
151
+ const calendar = earningsCalendar
152
+ .map((e) => ({
153
+ symbol: e.symbol,
154
+ date: e.date,
155
+ hour: e.hour,
156
+ epsEstimate: e.epsEstimate,
157
+ revenueEstimate: e.revenueEstimate,
158
+ year: e.year,
159
+ quarter: e.quarter,
160
+ }))
161
+ .sort((a, b) => a.date.localeCompare(b.date));
162
+ ctx.enrich.total(calendar.length);
163
+ if (calendar.length === 0) {
164
+ ctx.enrich.notice(`No earnings releases between ${from} and ${to}. Widen the date window.`);
165
+ }
166
+ const sliced = calendar.slice(0, input.limit);
167
+ if (calendar.length > input.limit) {
168
+ ctx.enrich.truncated({ shown: sliced.length, cap: input.limit });
169
+ }
170
+ return { mode: 'calendar', calendar: sliced };
171
+ },
172
+ format: (result) => {
173
+ const lines = [`**Earnings (${result.mode})**`];
174
+ if (result.history) {
175
+ lines.push('**Earnings history** (newest first):');
176
+ for (const q of result.history) {
177
+ const surprise = q.surprisePercent == null
178
+ ? 'n/a'
179
+ : `${q.surprisePercent > 0 ? '+' : ''}${q.surprisePercent.toFixed(2)}%`;
180
+ const actual = q.actualEPS == null ? 'n/a' : q.actualEPS;
181
+ const estimate = q.estimateEPS == null ? 'n/a' : q.estimateEPS;
182
+ const abs = q.surprise == null ? 'n/a' : q.surprise;
183
+ lines.push(`- ${q.period} (FY${q.year} Q${q.quarter}): actual ${actual} vs est ${estimate} → surprise ${surprise} (${abs} abs)`);
184
+ }
185
+ }
186
+ if (result.calendar) {
187
+ lines.push('**Upcoming earnings** (by date):');
188
+ for (const e of result.calendar) {
189
+ const eps = e.epsEstimate == null ? 'n/a' : e.epsEstimate;
190
+ const rev = e.revenueEstimate == null ? 'n/a' : e.revenueEstimate;
191
+ const hour = e.hour || 'time TBD';
192
+ lines.push(`- ${e.date} **${e.symbol}** (FY${e.year} Q${e.quarter}, ${hour}): EPS est ${eps}, revenue est ${rev}`);
193
+ }
194
+ }
195
+ if (lines.length === 0) {
196
+ lines.push('No earnings data.');
197
+ }
198
+ return [{ type: 'text', text: lines.join('\n') }];
199
+ },
200
+ });
201
+ //# sourceMappingURL=get-earnings.tool.js.map
@@ -0,0 +1 @@
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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"}
@@ -0,0 +1,55 @@
1
+ /**
2
+ * @fileoverview finnhub_get_news — financial news in two modes. `company`:
3
+ * recent articles for one symbol over a date range. `market`: broad market
4
+ * headlines by category. Mode-consolidated; both share the article shape.
5
+ * @module mcp-server/tools/definitions/get-news.tool
6
+ */
7
+ import { z } from '@cyanheads/mcp-ts-core';
8
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
9
+ export declare const getNews: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
10
+ mode: z.ZodEnum<{
11
+ company: "company";
12
+ market: "market";
13
+ }>;
14
+ symbol: z.ZodOptional<z.ZodString>;
15
+ from: z.ZodOptional<z.ZodString>;
16
+ to: z.ZodOptional<z.ZodString>;
17
+ category: z.ZodDefault<z.ZodEnum<{
18
+ general: "general";
19
+ forex: "forex";
20
+ crypto: "crypto";
21
+ merger: "merger";
22
+ }>>;
23
+ limit: z.ZodDefault<z.ZodNumber>;
24
+ }, z.core.$strip>, z.ZodObject<{
25
+ mode: z.ZodEnum<{
26
+ company: "company";
27
+ market: "market";
28
+ }>;
29
+ articles: z.ZodArray<z.ZodObject<{
30
+ headline: z.ZodString;
31
+ source: z.ZodString;
32
+ datetime: z.ZodString;
33
+ summary: z.ZodString;
34
+ url: z.ZodString;
35
+ category: z.ZodOptional<z.ZodString>;
36
+ related: z.ZodOptional<z.ZodString>;
37
+ }, z.core.$strip>>;
38
+ }, z.core.$strip>, readonly [{
39
+ readonly reason: "missing_symbol";
40
+ readonly code: JsonRpcErrorCode.InvalidParams;
41
+ readonly when: "mode 'company' was requested without a symbol.";
42
+ readonly recovery: "Provide a `symbol` for company mode, or switch to mode: market with a category.";
43
+ }, {
44
+ readonly reason: "not_us_or_paid";
45
+ readonly code: JsonRpcErrorCode.Forbidden;
46
+ readonly when: "Upstream HTTP 403 on the symbol.";
47
+ readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
48
+ }], {
49
+ readonly totalCount: z.ZodNumber;
50
+ readonly truncated: z.ZodOptional<z.ZodBoolean>;
51
+ readonly shown: z.ZodOptional<z.ZodNumber>;
52
+ readonly cap: z.ZodOptional<z.ZodNumber>;
53
+ readonly notice: z.ZodOptional<z.ZodString>;
54
+ }>;
55
+ //# sourceMappingURL=get-news.tool.d.ts.map
@@ -0,0 +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;AA8B3E,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoJlB,CAAC"}
@@ -0,0 +1,160 @@
1
+ /**
2
+ * @fileoverview finnhub_get_news — financial news in two modes. `company`:
3
+ * recent articles for one symbol over a date range. `market`: broad market
4
+ * headlines by category. Mode-consolidated; both share the article shape.
5
+ * @module mcp-server/tools/definitions/get-news.tool
6
+ */
7
+ import { tool, z } from '@cyanheads/mcp-ts-core';
8
+ import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
9
+ import { getFinnhubService } from '../../../services/finnhub/finnhub-service.js';
10
+ /** Format a Date as YYYY-MM-DD (UTC). */
11
+ function isoDate(date) {
12
+ return date.toISOString().slice(0, 10);
13
+ }
14
+ /** Normalize a raw Finnhub article to the output shape (epoch → ISO). */
15
+ function normalizeArticle(a) {
16
+ return {
17
+ headline: a.headline,
18
+ source: a.source,
19
+ datetime: new Date(a.datetime * 1000).toISOString(),
20
+ summary: a.summary ?? '',
21
+ url: a.url,
22
+ ...(a.category ? { category: a.category } : {}),
23
+ ...(a.related ? { related: a.related } : {}),
24
+ };
25
+ }
26
+ export const getNews = tool('finnhub_get_news', {
27
+ description: "Financial news in two modes. 'company': recent articles for one symbol over a date range — headline, source, datetime, summary, URL (\"what's driving AAPL today?\"); requires `symbol`. 'market': broad market headlines by category (general, forex, crypto, merger); uses `category`. Resolve a company name with finnhub_search_symbols first for company mode.",
28
+ annotations: { readOnlyHint: true, openWorldHint: true },
29
+ input: z.object({
30
+ mode: z
31
+ .enum(['company', 'market'])
32
+ .describe("'company' = recent articles for one symbol over a date range (requires `symbol`). 'market' = broad headlines by `category`."),
33
+ symbol: z
34
+ .string()
35
+ .optional()
36
+ .describe('Required for `company` mode. US ticker. Ignored in `market` mode.'),
37
+ from: z
38
+ .string()
39
+ .optional()
40
+ .describe('Company mode: window start (YYYY-MM-DD). Defaults to today − 7 days.'),
41
+ to: z.string().optional().describe('Company mode: window end (YYYY-MM-DD). Defaults to today.'),
42
+ category: z
43
+ .enum(['general', 'forex', 'crypto', 'merger'])
44
+ .default('general')
45
+ .describe('Market mode: news category. See finnhub://news-categories.'),
46
+ limit: z
47
+ .number()
48
+ .int()
49
+ .min(1)
50
+ .max(50)
51
+ .default(15)
52
+ .describe('Max articles. Default 15 — news lists run long; keep context lean.'),
53
+ }),
54
+ output: z.object({
55
+ mode: z.enum(['company', 'market']).describe('The mode used (echo of input).'),
56
+ articles: z
57
+ .array(z
58
+ .object({
59
+ headline: z.string().describe('Article headline.'),
60
+ source: z.string().describe('Publisher name.'),
61
+ datetime: z.string().describe('Publish time, ISO 8601.'),
62
+ summary: z.string().describe('Article summary (may be empty).'),
63
+ url: z.string().describe('Link to the article.'),
64
+ category: z
65
+ .string()
66
+ .optional()
67
+ .describe('Finnhub category tag (market mode). Note: the response category may differ from the requested category (e.g., "business" for a "general" request).'),
68
+ related: z.string().optional().describe('Related symbol(s) Finnhub tagged.'),
69
+ })
70
+ .describe('A single news article.'))
71
+ .describe('Articles, newest first.'),
72
+ }),
73
+ enrichment: {
74
+ totalCount: z.number().describe('Total articles available before the limit.'),
75
+ truncated: z.boolean().optional().describe('True when articles were capped at the limit.'),
76
+ shown: z.number().optional().describe('Number of articles returned.'),
77
+ cap: z.number().optional().describe('The limit that was applied.'),
78
+ notice: z.string().optional().describe('Guidance when no articles were found.'),
79
+ },
80
+ errors: [
81
+ {
82
+ reason: 'missing_symbol',
83
+ code: JsonRpcErrorCode.InvalidParams,
84
+ when: "mode 'company' was requested without a symbol.",
85
+ recovery: 'Provide a `symbol` for company mode, or switch to mode: market with a category.',
86
+ },
87
+ {
88
+ reason: 'not_us_or_paid',
89
+ code: JsonRpcErrorCode.Forbidden,
90
+ when: 'Upstream HTTP 403 on the symbol.',
91
+ recovery: 'Free tier is US equities only; use a US symbol or a paid plan.',
92
+ },
93
+ ],
94
+ async handler(input, ctx) {
95
+ const service = getFinnhubService();
96
+ let raw;
97
+ if (input.mode === 'company') {
98
+ if (!input.symbol) {
99
+ throw ctx.fail('missing_symbol', undefined, {
100
+ ...ctx.recoveryFor('missing_symbol'),
101
+ });
102
+ }
103
+ const symbol = input.symbol;
104
+ const today = new Date();
105
+ const from = input.from || isoDate(new Date(today.getTime() - 7 * 86_400_000));
106
+ const to = input.to || isoDate(today);
107
+ try {
108
+ raw = await service.companyNews(symbol, from, to, ctx);
109
+ }
110
+ catch (err) {
111
+ if (err instanceof McpError && err.code === JsonRpcErrorCode.Forbidden) {
112
+ throw ctx.fail('not_us_or_paid', undefined, {
113
+ symbol,
114
+ ...ctx.recoveryFor('not_us_or_paid'),
115
+ });
116
+ }
117
+ throw err;
118
+ }
119
+ if (raw.length === 0) {
120
+ ctx.enrich.notice(`No articles for "${symbol}" between ${from} and ${to}. Widen the date range.`);
121
+ }
122
+ }
123
+ else {
124
+ raw = await service.marketNews(input.category, ctx);
125
+ if (raw.length === 0) {
126
+ ctx.enrich.notice(`No articles in the "${input.category}" category right now.`);
127
+ }
128
+ }
129
+ const articles = raw.map(normalizeArticle).sort((a, b) => b.datetime.localeCompare(a.datetime));
130
+ ctx.enrich.total(articles.length);
131
+ const sliced = articles.slice(0, input.limit);
132
+ if (articles.length > input.limit) {
133
+ ctx.enrich.truncated({ shown: sliced.length, cap: input.limit });
134
+ }
135
+ ctx.log.info('News fetched', {
136
+ mode: input.mode,
137
+ total: articles.length,
138
+ returned: sliced.length,
139
+ });
140
+ return { mode: input.mode, articles: sliced };
141
+ },
142
+ format: (result) => {
143
+ const header = `**${result.mode} news**`;
144
+ if (result.articles.length === 0) {
145
+ return [{ type: 'text', text: `${header}\nNo articles.` }];
146
+ }
147
+ const lines = [header, ''];
148
+ for (const a of result.articles) {
149
+ const tag = a.category ? ` [${a.category}]` : '';
150
+ const related = a.related ? ` · related: ${a.related}` : '';
151
+ lines.push(`**${a.headline}** — ${a.source}, ${a.datetime}${tag}${related}`);
152
+ if (a.summary)
153
+ lines.push(a.summary);
154
+ lines.push(a.url);
155
+ lines.push('');
156
+ }
157
+ return [{ type: 'text', text: lines.join('\n').trimEnd() }];
158
+ },
159
+ });
160
+ //# sourceMappingURL=get-news.tool.js.map
@@ -0,0 +1 @@
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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"}
@@ -0,0 +1,35 @@
1
+ /**
2
+ * @fileoverview finnhub_get_quote — real-time price quote for one US stock
3
+ * symbol, paired with live market-status so the response states whether the
4
+ * price is live or the prior close. The market-hours flag is the whole reason
5
+ * this is not a one-line curl wrapper.
6
+ * @module mcp-server/tools/definitions/get-quote.tool
7
+ */
8
+ import { z } from '@cyanheads/mcp-ts-core';
9
+ import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
10
+ export declare const getQuote: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
11
+ symbol: z.ZodString;
12
+ }, z.core.$strip>, z.ZodObject<{
13
+ symbol: z.ZodString;
14
+ current: z.ZodNumber;
15
+ change: z.ZodNullable<z.ZodNumber>;
16
+ percentChange: z.ZodNullable<z.ZodNumber>;
17
+ high: z.ZodNumber;
18
+ low: z.ZodNumber;
19
+ open: z.ZodNumber;
20
+ previousClose: z.ZodNumber;
21
+ quoteTime: z.ZodString;
22
+ marketOpen: z.ZodNullable<z.ZodBoolean>;
23
+ priceIsLive: z.ZodBoolean;
24
+ }, z.core.$strip>, readonly [{
25
+ readonly reason: "symbol_not_found";
26
+ readonly code: JsonRpcErrorCode.NotFound;
27
+ readonly when: "Quote sentinel detected (c=0, t=0, d=null, dp=null) — unknown US symbol at HTTP 200.";
28
+ readonly recovery: "Verify the ticker, or call finnhub_search_symbols to resolve the company name to a valid US symbol.";
29
+ }, {
30
+ readonly reason: "not_us_or_paid";
31
+ readonly code: JsonRpcErrorCode.Forbidden;
32
+ readonly when: "Upstream HTTP 403 — international or paid-only symbol.";
33
+ readonly recovery: "This free Finnhub tier covers US stocks only; international symbols require a paid plan. Try the US listing of the company.";
34
+ }], undefined>;
35
+ //# sourceMappingURL=get-quote.tool.d.ts.map
@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;;;cAkJnB,CAAC"}
@@ -0,0 +1,132 @@
1
+ /**
2
+ * @fileoverview finnhub_get_quote — real-time price quote for one US stock
3
+ * symbol, paired with live market-status so the response states whether the
4
+ * price is live or the prior close. The market-hours flag is the whole reason
5
+ * this is not a one-line curl wrapper.
6
+ * @module mcp-server/tools/definitions/get-quote.tool
7
+ */
8
+ import { tool, z } from '@cyanheads/mcp-ts-core';
9
+ import { JsonRpcErrorCode, McpError } from '@cyanheads/mcp-ts-core/errors';
10
+ import { getFinnhubService } from '../../../services/finnhub/finnhub-service.js';
11
+ export const getQuote = tool('finnhub_get_quote', {
12
+ description: 'Real-time price quote for one US stock symbol: current, change, %change, open, high, low, previous close. Pairs the quote with live market-status so the response states whether the price is live or the prior close — never implies a stale price is live. Resolve a name to a symbol with finnhub_search_symbols first. International symbols (with an exchange suffix like ".TO") are not on the free tier and return a clear error.',
13
+ annotations: { readOnlyHint: true, openWorldHint: true },
14
+ input: z.object({
15
+ symbol: z
16
+ .string()
17
+ .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.'),
19
+ }),
20
+ output: z.object({
21
+ symbol: z.string().describe('The symbol quoted (echo of input).'),
22
+ current: z
23
+ .number()
24
+ .describe('Current price when the market is open; the most recent close when it is not — read `priceIsLive`.'),
25
+ change: z
26
+ .number()
27
+ .nullable()
28
+ .describe('Absolute change vs. previous close. Null when the data is unavailable.'),
29
+ percentChange: z
30
+ .number()
31
+ .nullable()
32
+ .describe('Percent change vs. previous close. Null when unavailable.'),
33
+ high: z.number().describe('Session high.'),
34
+ low: z.number().describe('Session low.'),
35
+ open: z.number().describe('Session open.'),
36
+ previousClose: z.number().describe('Previous trading day close.'),
37
+ quoteTime: z.string().describe('Quote timestamp as ISO 8601.'),
38
+ marketOpen: z
39
+ .boolean()
40
+ .nullable()
41
+ .describe('Whether the US market is currently open. Null when the market-status check failed.'),
42
+ priceIsLive: z
43
+ .boolean()
44
+ .describe('True only when the market is open. When false, `current` is the prior close, not a live price.'),
45
+ }),
46
+ errors: [
47
+ {
48
+ reason: 'symbol_not_found',
49
+ code: JsonRpcErrorCode.NotFound,
50
+ when: 'Quote sentinel detected (c=0, t=0, d=null, dp=null) — unknown US symbol at HTTP 200.',
51
+ recovery: 'Verify the ticker, or call finnhub_search_symbols to resolve the company name to a valid US symbol.',
52
+ },
53
+ {
54
+ reason: 'not_us_or_paid',
55
+ code: JsonRpcErrorCode.Forbidden,
56
+ when: 'Upstream HTTP 403 — international or paid-only symbol.',
57
+ recovery: 'This free Finnhub tier covers US stocks only; international symbols require a paid plan. Try the US listing of the company.',
58
+ },
59
+ ],
60
+ async handler(input, ctx) {
61
+ const service = getFinnhubService();
62
+ const [quoteResult, statusResult] = await Promise.allSettled([
63
+ service.quote(input.symbol, ctx),
64
+ service.marketStatus('US', ctx),
65
+ ]);
66
+ if (quoteResult.status === 'rejected') {
67
+ const err = quoteResult.reason;
68
+ if (err instanceof McpError && err.code === JsonRpcErrorCode.Forbidden) {
69
+ throw ctx.fail('not_us_or_paid', undefined, {
70
+ symbol: input.symbol,
71
+ ...ctx.recoveryFor('not_us_or_paid'),
72
+ });
73
+ }
74
+ throw err;
75
+ }
76
+ const quote = quoteResult.value;
77
+ // All-zero sentinel: an unknown US symbol returns {c:0,...,t:0} at HTTP 200.
78
+ // The status code cannot carry this — the payload shape must. d/dp are null
79
+ // in the sentinel, so the check keys on the always-numeric c and t.
80
+ if (quote.c === 0 && quote.t === 0) {
81
+ throw ctx.fail('symbol_not_found', `No quote for symbol "${input.symbol}".`, {
82
+ symbol: input.symbol,
83
+ ...ctx.recoveryFor('symbol_not_found'),
84
+ });
85
+ }
86
+ const marketOpen = statusResult.status === 'fulfilled' ? statusResult.value.isOpen : null;
87
+ const priceIsLive = marketOpen === true;
88
+ if (statusResult.status === 'rejected') {
89
+ ctx.log.warning('Market-status fetch failed; price freshness unknown', {
90
+ symbol: input.symbol,
91
+ });
92
+ }
93
+ return {
94
+ symbol: input.symbol,
95
+ current: quote.c,
96
+ change: quote.d,
97
+ percentChange: quote.dp,
98
+ high: quote.h,
99
+ low: quote.l,
100
+ open: quote.o,
101
+ previousClose: quote.pc,
102
+ quoteTime: new Date(quote.t * 1000).toISOString(),
103
+ marketOpen,
104
+ priceIsLive,
105
+ };
106
+ },
107
+ format: (result) => {
108
+ const arrow = result.percentChange == null
109
+ ? ''
110
+ : result.percentChange > 0
111
+ ? '▲'
112
+ : result.percentChange < 0
113
+ ? '▼'
114
+ : '▬';
115
+ const pct = result.percentChange == null
116
+ ? 'n/a'
117
+ : `${result.percentChange > 0 ? '+' : ''}${result.percentChange.toFixed(2)}%`;
118
+ const chg = result.change == null ? 'n/a' : result.change.toFixed(2);
119
+ const freshness = result.marketOpen == null
120
+ ? 'freshness unknown'
121
+ : result.priceIsLive
122
+ ? 'live'
123
+ : 'prior close — market closed';
124
+ const lines = [
125
+ `**${result.symbol}** $${result.current} ${arrow} ${pct} (${freshness})`,
126
+ `Change: ${chg} | Open: ${result.open} | High: ${result.high} | Low: ${result.low} | Prev close: ${result.previousClose}`,
127
+ `Quote time: ${result.quoteTime}${result.marketOpen == null ? '' : ` | Market open: ${result.marketOpen ? 'yes' : 'no'}`}`,
128
+ ];
129
+ return [{ type: 'text', text: lines.join('\n') }];
130
+ },
131
+ });
132
+ //# sourceMappingURL=get-quote.tool.js.map
@@ -0,0 +1 @@
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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"}