@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 +1 @@
|
|
|
1
|
-
{"version":3,"file":"finnhub-service.js","sourceRoot":"","sources":["../../../src/services/finnhub/finnhub-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE/F,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAa5D,qDAAqD;AACrD,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;GAIG;AACH,MAAM,mBAAmB,GAAG,KAAK,CAAC;AAElC;;;GAGG;AACH,MAAM,OAAO,cAAc;IACR,OAAO,CAAS;IAChB,MAAM,CAAS;IAEhC;QACE,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IACpC,CAAC;IAED,
|
|
1
|
+
{"version":3,"file":"finnhub-service.js","sourceRoot":"","sources":["../../../src/services/finnhub/finnhub-service.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Converts Finnhub headline and summary HTML fragments to text.
|
|
3
|
+
*/
|
|
4
|
+
/** Decode entities once and preserve paragraph and list-item boundaries from the parsed fragment. */
|
|
5
|
+
export declare function normalizeArticleText(value: string): string;
|
|
6
|
+
//# sourceMappingURL=normalize-article-text.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"normalize-article-text.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/normalize-article-text.ts"],"names":[],"mappings":"AAAA;;GAEG;AAgCH,qGAAqG;AACrG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAmE1D"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @fileoverview Converts Finnhub headline and summary HTML fragments to text.
|
|
3
|
+
*/
|
|
4
|
+
import { defaultTreeAdapter, html, parseFragment } from 'parse5';
|
|
5
|
+
const PARAGRAPH_TAGS = new Set([
|
|
6
|
+
'address',
|
|
7
|
+
'article',
|
|
8
|
+
'blockquote',
|
|
9
|
+
'dd',
|
|
10
|
+
'div',
|
|
11
|
+
'dl',
|
|
12
|
+
'dt',
|
|
13
|
+
'figcaption',
|
|
14
|
+
'figure',
|
|
15
|
+
'h1',
|
|
16
|
+
'h2',
|
|
17
|
+
'h3',
|
|
18
|
+
'h4',
|
|
19
|
+
'h5',
|
|
20
|
+
'h6',
|
|
21
|
+
'hr',
|
|
22
|
+
'ol',
|
|
23
|
+
'p',
|
|
24
|
+
'pre',
|
|
25
|
+
'section',
|
|
26
|
+
'table',
|
|
27
|
+
'ul',
|
|
28
|
+
]);
|
|
29
|
+
const HIDDEN_TAGS = new Set(['script', 'style', 'template']);
|
|
30
|
+
const HTML_WHITESPACE = /[\t\n\f\r ]+/g;
|
|
31
|
+
const COMPACT_COMPARISON = /[A-Za-z0-9]<[A-Za-z]>[A-Za-z0-9]/;
|
|
32
|
+
/** Decode entities once and preserve paragraph and list-item boundaries from the parsed fragment. */
|
|
33
|
+
export function normalizeArticleText(value) {
|
|
34
|
+
if (!value.includes('<') && !value.includes('&'))
|
|
35
|
+
return value.replace(/\r\n?/g, '\n');
|
|
36
|
+
// An unmatched '<' can be an ordinary comparison, even following real markup.
|
|
37
|
+
const tailStart = value.indexOf('<', value.lastIndexOf('>') + 1);
|
|
38
|
+
const fragment = tailStart === -1
|
|
39
|
+
? value
|
|
40
|
+
: value.slice(0, tailStart) + value.slice(tailStart).replaceAll('<', '<');
|
|
41
|
+
const { childNodes } = parseFragment(fragment, {
|
|
42
|
+
sourceCodeLocationInfo: COMPACT_COMPARISON.test(fragment),
|
|
43
|
+
});
|
|
44
|
+
if (!childNodes.some(defaultTreeAdapter.isElementNode)) {
|
|
45
|
+
return childNodes
|
|
46
|
+
.filter(defaultTreeAdapter.isTextNode)
|
|
47
|
+
.map((node) => node.value)
|
|
48
|
+
.join('')
|
|
49
|
+
.replace(/\r\n?/g, '\n');
|
|
50
|
+
}
|
|
51
|
+
const chunks = [];
|
|
52
|
+
let pendingBreaks = 0;
|
|
53
|
+
function appendText(value) {
|
|
54
|
+
const text = value.replace(HTML_WHITESPACE, ' ');
|
|
55
|
+
if (text === ' ' && pendingBreaks)
|
|
56
|
+
return;
|
|
57
|
+
if (pendingBreaks && chunks.length)
|
|
58
|
+
chunks.push('\n'.repeat(pendingBreaks));
|
|
59
|
+
pendingBreaks = 0;
|
|
60
|
+
chunks.push(text);
|
|
61
|
+
}
|
|
62
|
+
function visit(node) {
|
|
63
|
+
if (defaultTreeAdapter.isTextNode(node)) {
|
|
64
|
+
appendText(node.value);
|
|
65
|
+
return;
|
|
66
|
+
}
|
|
67
|
+
if (!defaultTreeAdapter.isElementNode(node) || HIDDEN_TAGS.has(node.tagName))
|
|
68
|
+
return;
|
|
69
|
+
if (node.tagName === 'br') {
|
|
70
|
+
pendingBreaks += 1;
|
|
71
|
+
return;
|
|
72
|
+
}
|
|
73
|
+
// HTML parsers read x<y>z as an opening tag. Preserve that exact operand
|
|
74
|
+
// pattern when the tag has no HTML meaning and no matching end tag.
|
|
75
|
+
const location = node.sourceCodeLocation;
|
|
76
|
+
const startTag = location?.startTag;
|
|
77
|
+
if (startTag &&
|
|
78
|
+
!location.endTag &&
|
|
79
|
+
html.getTagID(node.tagName) === html.TAG_ID.UNKNOWN &&
|
|
80
|
+
COMPACT_COMPARISON.test(fragment.slice(startTag.startOffset - 1, startTag.endOffset + 1))) {
|
|
81
|
+
appendText(fragment.slice(startTag.startOffset, startTag.endOffset));
|
|
82
|
+
}
|
|
83
|
+
const breaks = PARAGRAPH_TAGS.has(node.tagName) ? 2 : node.tagName === 'li' ? 1 : 0;
|
|
84
|
+
pendingBreaks = Math.max(pendingBreaks, breaks);
|
|
85
|
+
for (const child of node.childNodes)
|
|
86
|
+
visit(child);
|
|
87
|
+
pendingBreaks = Math.max(pendingBreaks, breaks);
|
|
88
|
+
}
|
|
89
|
+
for (const node of childNodes)
|
|
90
|
+
visit(node);
|
|
91
|
+
return chunks
|
|
92
|
+
.join('')
|
|
93
|
+
.replace(/ {2,}/g, ' ')
|
|
94
|
+
.replace(/ *\n */g, '\n')
|
|
95
|
+
.replace(/^ +| +$/g, '');
|
|
96
|
+
}
|
|
97
|
+
//# sourceMappingURL=normalize-article-text.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"normalize-article-text.js","sourceRoot":"","sources":["../../../src/services/finnhub/normalize-article-text.ts"],"names":[],"mappings":"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"}
|
|
@@ -108,12 +108,12 @@ export interface FinnhubEarning {
|
|
|
108
108
|
/** A single entry from `GET /calendar/earnings`. */
|
|
109
109
|
export interface FinnhubEarningsCalendarEntry {
|
|
110
110
|
date: string;
|
|
111
|
-
epsActual
|
|
111
|
+
epsActual?: number | null;
|
|
112
112
|
epsEstimate: number | null;
|
|
113
|
-
/** "bmo" (before open)
|
|
113
|
+
/** "bmo" (before open), "amc" (after close), "dmh" (during market hours), or "" when unknown. */
|
|
114
114
|
hour: string;
|
|
115
115
|
quarter: number;
|
|
116
|
-
revenueActual
|
|
116
|
+
revenueActual?: number | null;
|
|
117
117
|
revenueEstimate: number | null;
|
|
118
118
|
symbol: string;
|
|
119
119
|
year: number;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/types.ts"],"names":[],"mappings":"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
|
|
1
|
+
{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/finnhub/types.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/finnhub-mcp-server",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.1",
|
|
4
4
|
"mcpName": "io.github.cyanheads/finnhub-mcp-server",
|
|
5
5
|
"description": "Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.",
|
|
6
6
|
"type": "module",
|
|
@@ -75,7 +75,7 @@
|
|
|
75
75
|
"packageManager": "bun@1.4.4",
|
|
76
76
|
"author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
|
|
77
77
|
"engines": {
|
|
78
|
-
"bun": ">=1.4.
|
|
78
|
+
"bun": ">=1.4.4",
|
|
79
79
|
"node": ">=24.0.0"
|
|
80
80
|
},
|
|
81
81
|
"funding": [
|
|
@@ -92,18 +92,21 @@
|
|
|
92
92
|
"access": "public"
|
|
93
93
|
},
|
|
94
94
|
"dependencies": {
|
|
95
|
-
"@cyanheads/mcp-ts-core": "^0.13.
|
|
95
|
+
"@cyanheads/mcp-ts-core": "^0.13.22",
|
|
96
|
+
"parse5": "^8.1.1",
|
|
96
97
|
"pino-pretty": "^13.2.0",
|
|
97
98
|
"zod": "^4.6.7"
|
|
98
99
|
},
|
|
99
100
|
"devDependencies": {
|
|
100
|
-
"@biomejs/biome": "2.6.
|
|
101
|
+
"@biomejs/biome": "2.6.8",
|
|
101
102
|
"@socketsecurity/bun-security-scanner": "^1.1.3",
|
|
103
|
+
"@types/commonmark": "^0.27.10",
|
|
102
104
|
"@types/node": "26.6.6",
|
|
105
|
+
"commonmark": "^0.31.2",
|
|
103
106
|
"depcheck": "^1.4.7",
|
|
104
|
-
"ignore": "^7.0.
|
|
105
|
-
"tsc-alias": "^1.9.
|
|
107
|
+
"ignore": "^7.0.16",
|
|
108
|
+
"tsc-alias": "^1.9.10",
|
|
106
109
|
"typescript": "^7.0.2",
|
|
107
|
-
"vitest": "^5.
|
|
110
|
+
"vitest": "^5.1.1"
|
|
108
111
|
}
|
|
109
112
|
}
|
package/server.json
CHANGED
|
@@ -6,14 +6,14 @@
|
|
|
6
6
|
"url": "https://github.com/cyanheads/finnhub-mcp-server",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "0.2.
|
|
9
|
+
"version": "0.2.1",
|
|
10
10
|
"packages": [
|
|
11
11
|
{
|
|
12
12
|
"registryType": "npm",
|
|
13
13
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
14
14
|
"identifier": "@cyanheads/finnhub-mcp-server",
|
|
15
15
|
"runtimeHint": "npx",
|
|
16
|
-
"version": "0.2.
|
|
16
|
+
"version": "0.2.1",
|
|
17
17
|
"environmentVariables": [
|
|
18
18
|
{
|
|
19
19
|
"name": "FINNHUB_API_KEY",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
46
46
|
"identifier": "@cyanheads/finnhub-mcp-server",
|
|
47
47
|
"runtimeHint": "npx",
|
|
48
|
-
"version": "0.2.
|
|
48
|
+
"version": "0.2.1",
|
|
49
49
|
"environmentVariables": [
|
|
50
50
|
{
|
|
51
51
|
"name": "MCP_TRANSPORT_TYPE",
|
|
@@ -4,7 +4,7 @@ description: Build company and earnings briefings with finnhub_* tools, preservi
|
|
|
4
4
|
license: Apache-2.0
|
|
5
5
|
metadata:
|
|
6
6
|
author: "cyanheads"
|
|
7
|
-
version: "1.
|
|
7
|
+
version: "1.1"
|
|
8
8
|
---
|
|
9
9
|
|
|
10
10
|
## Scope
|
|
@@ -13,19 +13,19 @@ Use Finnhub for current equity context and financial news. This surface does not
|
|
|
13
13
|
|
|
14
14
|
## Identifiers
|
|
15
15
|
|
|
16
|
-
For an unfamiliar company or ambiguous ticker, select the intended security from `finnhub_search_symbols` using its name and security type, then carry the returned `symbol` through the briefing.
|
|
16
|
+
For an unfamiliar company or ambiguous ticker, select the intended security from `finnhub_search_symbols` using its name and security type, then carry the returned `symbol` through the briefing. Exact ticker matches can include several securities. For a US listing, try the US exchange filter. If a company-name search misses an ADR, try its ticker or a global search. Preserve class-share punctuation. Check endpoint coverage separately from the `isLikelyUS` symbol-format heuristic.
|
|
17
17
|
|
|
18
18
|
## Gates
|
|
19
19
|
|
|
20
20
|
- Before concluding that data is absent, establish the intended security and name the endpoint and window checked. An empty company-news window, empty earnings calendar, and missing analyst recommendations do not establish that the security is invalid or that no information exists elsewhere.
|
|
21
21
|
- Before interpreting missing fundamentals or peers, inspect `partial`. A failed component is unavailable; a null metric is not zero. A quote succeeding does not establish company-profile or analyst coverage for that security, including a fund or trust.
|
|
22
22
|
- Before describing a price as current, retain its quote timestamp and market-status context. A false `priceIsLive` alone does not establish a prior-close timestamp; unavailable market status means freshness is unknown. Preserve returned session and holiday information.
|
|
23
|
-
-
|
|
23
|
+
- For a calendar or company-news window, compare the dates you requested with the earliest and latest records Finnhub supplied. Follow `nextOffset` using the same filters to read further into that fetched set. Each call retrieves fresh data, so records can shift between pages. For older coverage, query an earlier window. Even a company-news response below 250 articles can omit an entire requested day.
|
|
24
24
|
|
|
25
25
|
## Workflows
|
|
26
26
|
|
|
27
|
-
**Company or earnings briefing.** Resolve the security, then use `finnhub_get_quote` and `finnhub_get_company` for price and business context.
|
|
27
|
+
**Company or earnings briefing.** Resolve the security, then use `finnhub_get_quote` and `finnhub_get_company` for price and business context. To check a recent revenue beat or miss, query the earnings calendar by symbol around the release date. Compare reported revenue with the estimate on the same row when both are available. For quarterly EPS surprises, use earnings history. Keep release dates, fiscal periods, quote timestamps, article publication times, and analyst recommendation periods attached to their respective claims.
|
|
28
28
|
|
|
29
29
|
**Missing data.** Recheck identity before changing the question. Distinguish access denial, an unavailable component, and an empty endpoint result. Widen an empty news or calendar window when the task calls for it; use earnings history to investigate past results. Report the narrow outcome, such as “Finnhub returned no calendar entries for this company in this window,” rather than inferring no scheduled earnings or no company coverage.
|
|
30
30
|
|
|
31
|
-
**Peer comparison.**
|
|
31
|
+
**Peer comparison.** Use the default sub-industry grouping for close competitors. Request `sector` for a broader comparison and record the grouping alongside the results. Exclude the queried security itself, fetch the selected peers' company context, and preserve missing values and failed components.
|