@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.
Files changed (47) hide show
  1. package/AGENTS.md +7 -5
  2. package/CLAUDE.md +7 -5
  3. package/README.md +15 -12
  4. package/changelog/0.2.x/0.2.1.md +35 -0
  5. package/changelog/template.md +10 -3
  6. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +11 -1
  7. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -1
  8. package/dist/mcp-server/tools/definitions/get-company.tool.js +11 -5
  9. package/dist/mcp-server/tools/definitions/get-company.tool.js.map +1 -1
  10. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts +25 -2
  11. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts.map +1 -1
  12. package/dist/mcp-server/tools/definitions/get-earnings.tool.js +84 -40
  13. package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -1
  14. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts +16 -0
  15. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts.map +1 -1
  16. package/dist/mcp-server/tools/definitions/get-news.tool.js +87 -33
  17. package/dist/mcp-server/tools/definitions/get-news.tool.js.map +1 -1
  18. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts.map +1 -1
  19. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js +1 -2
  20. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -1
  21. package/dist/mcp-server/tools/definitions/index.d.ts +135 -84
  22. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  23. package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts +2 -0
  24. package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts.map +1 -1
  25. package/dist/mcp-server/tools/definitions/search-symbols.tool.js +28 -18
  26. package/dist/mcp-server/tools/definitions/search-symbols.tool.js.map +1 -1
  27. package/dist/mcp-server/tools/definitions/window-page.d.ts +21 -0
  28. package/dist/mcp-server/tools/definitions/window-page.d.ts.map +1 -0
  29. package/dist/mcp-server/tools/definitions/window-page.js +39 -0
  30. package/dist/mcp-server/tools/definitions/window-page.js.map +1 -0
  31. package/dist/services/finnhub/date-window.d.ts +13 -0
  32. package/dist/services/finnhub/date-window.d.ts.map +1 -0
  33. package/dist/services/finnhub/date-window.js +32 -0
  34. package/dist/services/finnhub/date-window.js.map +1 -0
  35. package/dist/services/finnhub/finnhub-service.d.ts +4 -4
  36. package/dist/services/finnhub/finnhub-service.d.ts.map +1 -1
  37. package/dist/services/finnhub/finnhub-service.js +6 -6
  38. package/dist/services/finnhub/finnhub-service.js.map +1 -1
  39. package/dist/services/finnhub/normalize-article-text.d.ts +6 -0
  40. package/dist/services/finnhub/normalize-article-text.d.ts.map +1 -0
  41. package/dist/services/finnhub/normalize-article-text.js +97 -0
  42. package/dist/services/finnhub/normalize-article-text.js.map +1 -0
  43. package/dist/services/finnhub/types.d.ts +3 -3
  44. package/dist/services/finnhub/types.d.ts.map +1 -1
  45. package/package.json +10 -7
  46. package/server.json +3 -3
  47. 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":"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"}
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('<', '&lt;');
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: number | null;
111
+ epsActual?: number | null;
112
112
  epsEstimate: number | null;
113
- /** "bmo" (before open) / "amc" (after close) / "" when unknown. */
113
+ /** "bmo" (before open), "amc" (after close), "dmh" (during market hours), or "" when unknown. */
114
114
  hour: string;
115
115
  quarter: number;
116
- revenueActual: number | null;
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.0",
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.0",
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.18",
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.4",
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.14",
105
- "tsc-alias": "^1.9.9",
107
+ "ignore": "^7.0.16",
108
+ "tsc-alias": "^1.9.10",
106
109
  "typescript": "^7.0.2",
107
- "vitest": "^5.0.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.0",
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.0",
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.0",
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.0"
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. Do not substitute its display label or rewrite class-share punctuation. `isLikelyUS` is a symbol-format heuristic; a successful search does not establish access to every endpoint.
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
- - Before claiming a list is complete, inspect truncation and totals. Increasing a limit can expose more of the fetched response, not establish exhaustive historical coverage. Do not promise a fixed depth of analyst history.
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. For a company's next release, use its symbol with `finnhub_get_earnings` calendar mode; use history separately for reported EPS and surprises. Add `finnhub_get_news` company news for the relevant event window and `finnhub_get_recommendations` when analyst context is needed. Keep quote timestamps, fiscal periods, expected release dates, article publication times, and recommendation periods attached to their respective claims.
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.** Start from the company response's peer symbols and exclude the queried security itself. Fetch the chosen peers' company context before comparing fundamentals; preserve missing values and failed components in the 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.