@cyanheads/finnhub-mcp-server 0.1.1 → 0.1.3
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 +37 -31
- package/CLAUDE.md +37 -31
- package/Dockerfile +22 -7
- package/LICENSE +1 -1
- package/README.md +8 -6
- package/changelog/0.1.x/0.1.2.md +36 -0
- package/changelog/0.1.x/0.1.3.md +21 -0
- package/changelog/template.md +60 -19
- package/dist/index.js +0 -0
- package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts +3 -3
- package/dist/mcp-server/tools/definitions/get-earnings.tool.js +1 -1
- package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-news.tool.d.ts +3 -3
- package/dist/mcp-server/tools/definitions/get-news.tool.js +1 -1
- package/dist/mcp-server/tools/definitions/get-news.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +89 -89
- package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-symbols.tool.js +16 -10
- package/dist/mcp-server/tools/definitions/search-symbols.tool.js.map +1 -1
- package/dist/services/finnhub/finnhub-service.d.ts +12 -12
- package/dist/services/finnhub/finnhub-service.d.ts.map +1 -1
- package/dist/services/finnhub/finnhub-service.js.map +1 -1
- package/package.json +19 -9
- package/server.json +3 -3
package/changelog/template.md
CHANGED
|
@@ -4,10 +4,11 @@
|
|
|
4
4
|
# to author a new release. Set that file's H1 to `# <version> — YYYY-MM-DD`
|
|
5
5
|
# with a concrete date.
|
|
6
6
|
|
|
7
|
-
# Required. One-line GitHub Release-style headline. 350 character cap
|
|
8
|
-
# Default short and scannable. Don't pad, don't stitch
|
|
9
|
-
#
|
|
10
|
-
#
|
|
7
|
+
# Required. One-line GitHub Release-style headline. 350 character cap — a
|
|
8
|
+
# ceiling, not a target. Default short and scannable. Don't pad, don't stitch
|
|
9
|
+
# unrelated changes with commas/semicolons into an inventory — pick the
|
|
10
|
+
# headline, like a tag's theme line. Quotes required: unquoted YAML treats
|
|
11
|
+
# `: ` inside the value as a key separator and fails GitHub's strict parser.
|
|
11
12
|
summary: ""
|
|
12
13
|
|
|
13
14
|
# Set `true` when consumers must change code to upgrade: API removals,
|
|
@@ -15,16 +16,19 @@ summary: ""
|
|
|
15
16
|
# usage. Flagged as `Breaking` in the rollup.
|
|
16
17
|
breaking: false
|
|
17
18
|
|
|
18
|
-
# Set `true`
|
|
19
|
-
#
|
|
20
|
-
#
|
|
19
|
+
# Set `true` ONLY for a security fix in THIS project's own source code — a
|
|
20
|
+
# vulnerability or hardening in code you ship. A dependency or transitive CVE
|
|
21
|
+
# bump is routine maintenance, NOT a security release: record it under
|
|
22
|
+
# `## Dependencies` (with the advisory ID) and leave this `false`. When true,
|
|
23
|
+
# pairs with the `## Security` section below and flags `Security` in the rollup.
|
|
21
24
|
security: false
|
|
22
25
|
|
|
23
26
|
# Optional free-form notes for maintenance agents processing this release.
|
|
24
27
|
# Not rendered in CHANGELOG — consumed by agents running `maintenance` on
|
|
25
|
-
# downstream servers.
|
|
26
|
-
#
|
|
27
|
-
#
|
|
28
|
+
# downstream servers. ADOPTION STEPS ONLY — new files to create, fields to
|
|
29
|
+
# populate, one-time migration steps. Never a second rendering of the body:
|
|
30
|
+
# if a body bullet already says it, name the bullet's symbol instead of
|
|
31
|
+
# re-explaining. Omit the field entirely when there's nothing to say.
|
|
28
32
|
# agent-notes: |
|
|
29
33
|
# <instructions for downstream maintenance agents>
|
|
30
34
|
---
|
|
@@ -39,17 +43,54 @@ security: false
|
|
|
39
43
|
each bullet with the symbol or concept name in **bold** so they can skip
|
|
40
44
|
what's irrelevant and zoom in on what's not.
|
|
41
45
|
|
|
42
|
-
Tone: terse, fact-dense, not verbose.
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
46
|
+
Tone: terse, fact-dense, not verbose. Bullet shape: **symbol** + what
|
|
47
|
+
changed + at most one consumer-facing caveat. One sentence by default, two
|
|
48
|
+
when the second carries weight — a bullet past ~40 words or three sentences
|
|
49
|
+
is wrong. The depth lives one hop away: the linked issue carries the why,
|
|
50
|
+
the commit diff carries the how. The changelog names what changed and what
|
|
51
|
+
a consumer does about it; a reader who wants mechanism opens the link.
|
|
52
|
+
|
|
53
|
+
Model length on THIS guide, never on the previous entry — entries modeled
|
|
54
|
+
on entries compound.
|
|
55
|
+
|
|
56
|
+
Cut (each has shipped as a wall of text; these are the cruft):
|
|
57
|
+
- History/justification narration — how the bug worked, why the old
|
|
58
|
+
behavior was wrong. One short clause at most; the issue carries the story.
|
|
59
|
+
- Design-rationale defense — "chosen over Y because…", "guarding the
|
|
60
|
+
getter is not enough…". That is the author arguing with a reviewer;
|
|
61
|
+
reviewers read the PR, not the changelog.
|
|
62
|
+
- Defensive unchanged-clauses — "X is unchanged", "byte-identical to
|
|
63
|
+
<prev>". Keep one only where its absence would cause a real misread,
|
|
64
|
+
as a short parenthetical.
|
|
65
|
+
- Edge-case inventories — marker lists, not-flagged lists, escape tables.
|
|
66
|
+
Tests and the issue carry those.
|
|
67
|
+
- Mechanism walkthroughs (JSDoc, CLAUDE.md/AGENTS.md, or the relevant
|
|
68
|
+
skill own those), ceremonial framings ("This release introduces…"),
|
|
69
|
+
backwards-compat paragraphs, file-by-file test enumerations. Prefer
|
|
70
|
+
code/symbol names over English re-explanations.
|
|
71
|
+
|
|
72
|
+
Verified ≠ included: the every-claim-verified-from-the-diff rule bounds
|
|
73
|
+
the TRUTH of what you write, never the AMOUNT.
|
|
74
|
+
|
|
75
|
+
Example — same fact, right size:
|
|
76
|
+
|
|
77
|
+
TOO LONG: **`fetchWithTimeout`'s `timeoutMs` bounds the whole exchange**
|
|
78
|
+
(#341). `fetch` resolves once headers arrive and the deadline was
|
|
79
|
+
cleared as the helper returned, so a peer that answered promptly and
|
|
80
|
+
then stalled the stream held the request open indefinitely. A 2xx
|
|
81
|
+
carrying a body now comes back as a passthrough wrapper that disarms
|
|
82
|
+
the deadline when the body closes, errors, or is cancelled; …
|
|
83
|
+
[+90 more words of mechanism and edge cases]
|
|
84
|
+
|
|
85
|
+
RIGHT: **`fetchWithTimeout`'s `timeoutMs` now bounds the whole
|
|
86
|
+
exchange, not just the headers** (#341). A stalled body aborts with
|
|
87
|
+
the same `Timeout` error; the returned `Response` is a wrapper, so
|
|
88
|
+
identity assertions (`toBe(response)`) no longer hold.
|
|
50
89
|
|
|
51
90
|
Narrative intro: skip by default. Add one short sentence only when the
|
|
52
|
-
release theme genuinely needs framing the bullets can't carry.
|
|
91
|
+
release theme genuinely needs framing the bullets can't carry. When many
|
|
92
|
+
bullets share one upgrade consequence, state it ONCE — intro line or
|
|
93
|
+
agent-notes — never per bullet.
|
|
53
94
|
|
|
54
95
|
Sections: Keep a Changelog order — Added, Changed, Deprecated, Removed,
|
|
55
96
|
Fixed, Security. Include only sections with entries; delete the rest
|
package/dist/index.js
CHANGED
|
File without changes
|
|
@@ -9,8 +9,8 @@ import { z } from '@cyanheads/mcp-ts-core';
|
|
|
9
9
|
import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
|
|
10
10
|
export declare const getEarnings: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
|
|
11
11
|
mode: z.ZodEnum<{
|
|
12
|
-
history: "history";
|
|
13
12
|
calendar: "calendar";
|
|
13
|
+
history: "history";
|
|
14
14
|
}>;
|
|
15
15
|
symbol: z.ZodOptional<z.ZodString>;
|
|
16
16
|
from: z.ZodOptional<z.ZodString>;
|
|
@@ -18,8 +18,8 @@ export declare const getEarnings: import("@cyanheads/mcp-ts-core").ToolDefinitio
|
|
|
18
18
|
limit: z.ZodDefault<z.ZodNumber>;
|
|
19
19
|
}, z.core.$strip>, z.ZodObject<{
|
|
20
20
|
mode: z.ZodEnum<{
|
|
21
|
-
history: "history";
|
|
22
21
|
calendar: "calendar";
|
|
22
|
+
history: "history";
|
|
23
23
|
}>;
|
|
24
24
|
history: z.ZodOptional<z.ZodArray<z.ZodObject<{
|
|
25
25
|
period: z.ZodString;
|
|
@@ -41,7 +41,7 @@ export declare const getEarnings: import("@cyanheads/mcp-ts-core").ToolDefinitio
|
|
|
41
41
|
}, z.core.$strip>>>;
|
|
42
42
|
}, z.core.$strip>, readonly [{
|
|
43
43
|
readonly reason: "missing_symbol";
|
|
44
|
-
readonly code: JsonRpcErrorCode.
|
|
44
|
+
readonly code: JsonRpcErrorCode.ValidationError;
|
|
45
45
|
readonly when: "mode 'history' was requested without a symbol.";
|
|
46
46
|
readonly recovery: "Provide a `symbol` for history mode, or switch to mode: calendar for the market-wide upcoming-releases feed.";
|
|
47
47
|
}, {
|
|
@@ -91,7 +91,7 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
91
91
|
errors: [
|
|
92
92
|
{
|
|
93
93
|
reason: 'missing_symbol',
|
|
94
|
-
code: JsonRpcErrorCode.
|
|
94
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
95
95
|
when: "mode 'history' was requested without a symbol.",
|
|
96
96
|
recovery: 'Provide a `symbol` for history mode, or switch to mode: calendar for the market-wide upcoming-releases feed.',
|
|
97
97
|
},
|
|
@@ -1 +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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
|
|
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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"}
|
|
@@ -15,9 +15,9 @@ export declare const getNews: import("@cyanheads/mcp-ts-core").ToolDefinition<z.
|
|
|
15
15
|
from: z.ZodOptional<z.ZodString>;
|
|
16
16
|
to: z.ZodOptional<z.ZodString>;
|
|
17
17
|
category: z.ZodDefault<z.ZodEnum<{
|
|
18
|
-
general: "general";
|
|
19
|
-
forex: "forex";
|
|
20
18
|
crypto: "crypto";
|
|
19
|
+
forex: "forex";
|
|
20
|
+
general: "general";
|
|
21
21
|
merger: "merger";
|
|
22
22
|
}>>;
|
|
23
23
|
limit: z.ZodDefault<z.ZodNumber>;
|
|
@@ -37,7 +37,7 @@ export declare const getNews: import("@cyanheads/mcp-ts-core").ToolDefinition<z.
|
|
|
37
37
|
}, z.core.$strip>>;
|
|
38
38
|
}, z.core.$strip>, readonly [{
|
|
39
39
|
readonly reason: "missing_symbol";
|
|
40
|
-
readonly code: JsonRpcErrorCode.
|
|
40
|
+
readonly code: JsonRpcErrorCode.ValidationError;
|
|
41
41
|
readonly when: "mode 'company' was requested without a symbol.";
|
|
42
42
|
readonly recovery: "Provide a `symbol` for company mode, or switch to mode: market with a category.";
|
|
43
43
|
}, {
|
|
@@ -80,7 +80,7 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
80
80
|
errors: [
|
|
81
81
|
{
|
|
82
82
|
reason: 'missing_symbol',
|
|
83
|
-
code: JsonRpcErrorCode.
|
|
83
|
+
code: JsonRpcErrorCode.ValidationError,
|
|
84
84
|
when: "mode 'company' was requested without a symbol.",
|
|
85
85
|
recovery: 'Provide a `symbol` for company mode, or switch to mode: market with a category.',
|
|
86
86
|
},
|
|
@@ -1 +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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
|
|
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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"}
|
|
@@ -4,6 +4,92 @@
|
|
|
4
4
|
* @module mcp-server/tools/definitions/index
|
|
5
5
|
*/
|
|
6
6
|
export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
7
|
+
mode: import("zod").ZodEnum<{
|
|
8
|
+
company: "company";
|
|
9
|
+
market: "market";
|
|
10
|
+
}>;
|
|
11
|
+
symbol: import("zod").ZodOptional<import("zod").ZodString>;
|
|
12
|
+
from: import("zod").ZodOptional<import("zod").ZodString>;
|
|
13
|
+
to: import("zod").ZodOptional<import("zod").ZodString>;
|
|
14
|
+
category: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
15
|
+
crypto: "crypto";
|
|
16
|
+
forex: "forex";
|
|
17
|
+
general: "general";
|
|
18
|
+
merger: "merger";
|
|
19
|
+
}>>;
|
|
20
|
+
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
21
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
22
|
+
mode: import("zod").ZodEnum<{
|
|
23
|
+
company: "company";
|
|
24
|
+
market: "market";
|
|
25
|
+
}>;
|
|
26
|
+
articles: import("zod").ZodArray<import("zod").ZodObject<{
|
|
27
|
+
headline: import("zod").ZodString;
|
|
28
|
+
source: import("zod").ZodString;
|
|
29
|
+
datetime: import("zod").ZodString;
|
|
30
|
+
summary: import("zod").ZodString;
|
|
31
|
+
url: import("zod").ZodString;
|
|
32
|
+
category: import("zod").ZodOptional<import("zod").ZodString>;
|
|
33
|
+
related: import("zod").ZodOptional<import("zod").ZodString>;
|
|
34
|
+
}, import("zod/v4/core").$strip>>;
|
|
35
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
36
|
+
readonly reason: "missing_symbol";
|
|
37
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
38
|
+
readonly when: "mode 'company' was requested without a symbol.";
|
|
39
|
+
readonly recovery: "Provide a `symbol` for company mode, or switch to mode: market with a category.";
|
|
40
|
+
}, {
|
|
41
|
+
readonly reason: "not_us_or_paid";
|
|
42
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
43
|
+
readonly when: "Upstream HTTP 403 on the symbol.";
|
|
44
|
+
readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
|
|
45
|
+
}], {
|
|
46
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
47
|
+
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
48
|
+
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
49
|
+
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
50
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
51
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
52
|
+
query: import("zod").ZodString;
|
|
53
|
+
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
54
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
55
|
+
results: import("zod").ZodArray<import("zod").ZodObject<{
|
|
56
|
+
symbol: import("zod").ZodString;
|
|
57
|
+
displaySymbol: import("zod").ZodString;
|
|
58
|
+
description: import("zod").ZodString;
|
|
59
|
+
type: import("zod").ZodString;
|
|
60
|
+
isLikelyUS: import("zod").ZodBoolean;
|
|
61
|
+
}, import("zod/v4/core").$strip>>;
|
|
62
|
+
}, import("zod/v4/core").$strip>, undefined, {
|
|
63
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
64
|
+
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
65
|
+
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
66
|
+
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
67
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
68
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
69
|
+
symbol: import("zod").ZodString;
|
|
70
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
71
|
+
symbol: import("zod").ZodString;
|
|
72
|
+
current: import("zod").ZodNumber;
|
|
73
|
+
change: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
74
|
+
percentChange: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
75
|
+
high: import("zod").ZodNumber;
|
|
76
|
+
low: import("zod").ZodNumber;
|
|
77
|
+
open: import("zod").ZodNumber;
|
|
78
|
+
previousClose: import("zod").ZodNumber;
|
|
79
|
+
quoteTime: import("zod").ZodString;
|
|
80
|
+
marketOpen: import("zod").ZodNullable<import("zod").ZodBoolean>;
|
|
81
|
+
priceIsLive: import("zod").ZodBoolean;
|
|
82
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
83
|
+
readonly reason: "symbol_not_found";
|
|
84
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
85
|
+
readonly when: "Quote sentinel detected (c=0, t=0, d=null, dp=null) — unknown US symbol at HTTP 200.";
|
|
86
|
+
readonly recovery: "Verify the ticker, or call finnhub_search_symbols to resolve the company name to a valid US symbol.";
|
|
87
|
+
}, {
|
|
88
|
+
readonly reason: "not_us_or_paid";
|
|
89
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
90
|
+
readonly when: "Upstream HTTP 403 — international or paid-only symbol.";
|
|
91
|
+
readonly recovery: "This free Finnhub tier covers US stocks only; international symbols require a paid plan. Try the US listing of the company.";
|
|
92
|
+
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
7
93
|
symbol: import("zod").ZodString;
|
|
8
94
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
9
95
|
symbol: import("zod").ZodString;
|
|
@@ -45,8 +131,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
45
131
|
readonly recovery: "Free tier is US equities only; international symbols need a paid Finnhub plan. Try the company's US listing.";
|
|
46
132
|
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
47
133
|
mode: import("zod").ZodEnum<{
|
|
48
|
-
history: "history";
|
|
49
134
|
calendar: "calendar";
|
|
135
|
+
history: "history";
|
|
50
136
|
}>;
|
|
51
137
|
symbol: import("zod").ZodOptional<import("zod").ZodString>;
|
|
52
138
|
from: import("zod").ZodOptional<import("zod").ZodString>;
|
|
@@ -54,8 +140,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
54
140
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
55
141
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
56
142
|
mode: import("zod").ZodEnum<{
|
|
57
|
-
history: "history";
|
|
58
143
|
calendar: "calendar";
|
|
144
|
+
history: "history";
|
|
59
145
|
}>;
|
|
60
146
|
history: import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodObject<{
|
|
61
147
|
period: import("zod").ZodString;
|
|
@@ -77,7 +163,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
77
163
|
}, import("zod/v4/core").$strip>>>;
|
|
78
164
|
}, import("zod/v4/core").$strip>, readonly [{
|
|
79
165
|
readonly reason: "missing_symbol";
|
|
80
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.
|
|
166
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
81
167
|
readonly when: "mode 'history' was requested without a symbol.";
|
|
82
168
|
readonly recovery: "Provide a `symbol` for history mode, or switch to mode: calendar for the market-wide upcoming-releases feed.";
|
|
83
169
|
}, {
|
|
@@ -92,75 +178,6 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
92
178
|
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
93
179
|
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
94
180
|
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
95
|
-
mode: import("zod").ZodEnum<{
|
|
96
|
-
company: "company";
|
|
97
|
-
market: "market";
|
|
98
|
-
}>;
|
|
99
|
-
symbol: import("zod").ZodOptional<import("zod").ZodString>;
|
|
100
|
-
from: import("zod").ZodOptional<import("zod").ZodString>;
|
|
101
|
-
to: import("zod").ZodOptional<import("zod").ZodString>;
|
|
102
|
-
category: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
103
|
-
general: "general";
|
|
104
|
-
forex: "forex";
|
|
105
|
-
crypto: "crypto";
|
|
106
|
-
merger: "merger";
|
|
107
|
-
}>>;
|
|
108
|
-
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
109
|
-
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
110
|
-
mode: import("zod").ZodEnum<{
|
|
111
|
-
company: "company";
|
|
112
|
-
market: "market";
|
|
113
|
-
}>;
|
|
114
|
-
articles: import("zod").ZodArray<import("zod").ZodObject<{
|
|
115
|
-
headline: import("zod").ZodString;
|
|
116
|
-
source: import("zod").ZodString;
|
|
117
|
-
datetime: import("zod").ZodString;
|
|
118
|
-
summary: import("zod").ZodString;
|
|
119
|
-
url: import("zod").ZodString;
|
|
120
|
-
category: import("zod").ZodOptional<import("zod").ZodString>;
|
|
121
|
-
related: import("zod").ZodOptional<import("zod").ZodString>;
|
|
122
|
-
}, import("zod/v4/core").$strip>>;
|
|
123
|
-
}, import("zod/v4/core").$strip>, readonly [{
|
|
124
|
-
readonly reason: "missing_symbol";
|
|
125
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.InvalidParams;
|
|
126
|
-
readonly when: "mode 'company' was requested without a symbol.";
|
|
127
|
-
readonly recovery: "Provide a `symbol` for company mode, or switch to mode: market with a category.";
|
|
128
|
-
}, {
|
|
129
|
-
readonly reason: "not_us_or_paid";
|
|
130
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
131
|
-
readonly when: "Upstream HTTP 403 on the symbol.";
|
|
132
|
-
readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
|
|
133
|
-
}], {
|
|
134
|
-
readonly totalCount: import("zod").ZodNumber;
|
|
135
|
-
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
136
|
-
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
137
|
-
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
138
|
-
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
139
|
-
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
140
|
-
symbol: import("zod").ZodString;
|
|
141
|
-
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
142
|
-
symbol: import("zod").ZodString;
|
|
143
|
-
current: import("zod").ZodNumber;
|
|
144
|
-
change: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
145
|
-
percentChange: import("zod").ZodNullable<import("zod").ZodNumber>;
|
|
146
|
-
high: import("zod").ZodNumber;
|
|
147
|
-
low: import("zod").ZodNumber;
|
|
148
|
-
open: import("zod").ZodNumber;
|
|
149
|
-
previousClose: import("zod").ZodNumber;
|
|
150
|
-
quoteTime: import("zod").ZodString;
|
|
151
|
-
marketOpen: import("zod").ZodNullable<import("zod").ZodBoolean>;
|
|
152
|
-
priceIsLive: import("zod").ZodBoolean;
|
|
153
|
-
}, import("zod/v4/core").$strip>, readonly [{
|
|
154
|
-
readonly reason: "symbol_not_found";
|
|
155
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
156
|
-
readonly when: "Quote sentinel detected (c=0, t=0, d=null, dp=null) — unknown US symbol at HTTP 200.";
|
|
157
|
-
readonly recovery: "Verify the ticker, or call finnhub_search_symbols to resolve the company name to a valid US symbol.";
|
|
158
|
-
}, {
|
|
159
|
-
readonly reason: "not_us_or_paid";
|
|
160
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
161
|
-
readonly when: "Upstream HTTP 403 — international or paid-only symbol.";
|
|
162
|
-
readonly recovery: "This free Finnhub tier covers US stocks only; international symbols require a paid plan. Try the US listing of the company.";
|
|
163
|
-
}], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
164
181
|
symbol: import("zod").ZodString;
|
|
165
182
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
166
183
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
@@ -188,22 +205,5 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
188
205
|
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
189
206
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
190
207
|
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
191
|
-
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
192
|
-
query: import("zod").ZodString;
|
|
193
|
-
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
194
|
-
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
195
|
-
results: import("zod").ZodArray<import("zod").ZodObject<{
|
|
196
|
-
symbol: import("zod").ZodString;
|
|
197
|
-
displaySymbol: import("zod").ZodString;
|
|
198
|
-
description: import("zod").ZodString;
|
|
199
|
-
type: import("zod").ZodString;
|
|
200
|
-
isLikelyUS: import("zod").ZodBoolean;
|
|
201
|
-
}, import("zod/v4/core").$strip>>;
|
|
202
|
-
}, import("zod/v4/core").$strip>, undefined, {
|
|
203
|
-
readonly totalCount: import("zod").ZodNumber;
|
|
204
|
-
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
205
|
-
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
206
|
-
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
207
|
-
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
208
208
|
}>)[];
|
|
209
209
|
//# sourceMappingURL=index.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-symbols.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-symbols.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"search-symbols.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-symbols.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAMjD,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;EA0HxB,CAAC"}
|
|
@@ -6,21 +6,26 @@
|
|
|
6
6
|
*/
|
|
7
7
|
import { tool, z } from '@cyanheads/mcp-ts-core';
|
|
8
8
|
import { getFinnhubService } from '../../../services/finnhub/finnhub-service.js';
|
|
9
|
+
/** Finnhub uses `.A` and `.B` for US class-share symbols as well as dots for exchanges. */
|
|
10
|
+
const US_CLASS_SHARE_SYMBOL = /^[A-Z]+\.[AB]$/;
|
|
9
11
|
export const searchSymbols = tool('finnhub_search_symbols', {
|
|
10
|
-
description: 'Resolve a company name or partial ticker to Finnhub stock symbols. The entry point for every other tool — users say "Microsoft", the rest of the surface needs "MSFT". Returns matched symbols with display symbol, description, and security type, best US match first. Each result carries isLikelyUS
|
|
12
|
+
description: 'Resolve a company name or partial ticker to Finnhub stock symbols. The entry point for every other tool — users say "Microsoft", the rest of the surface needs "MSFT". Returns matched symbols with display symbol, description, and security type, best likely-US match first. Each result carries isLikelyUS, a symbol-format heuristic for likely free-tier availability; quote and profile responses remain authoritative.',
|
|
11
13
|
annotations: { readOnlyHint: true, openWorldHint: true },
|
|
12
14
|
input: z.object({
|
|
13
15
|
query: z
|
|
14
16
|
.string()
|
|
15
17
|
.min(1)
|
|
16
|
-
.
|
|
18
|
+
.max(20, {
|
|
19
|
+
message: 'Finnhub search queries are limited to 20 characters. Use a shorter company name or ticker fragment.',
|
|
20
|
+
})
|
|
21
|
+
.describe('Company name (e.g., "Apple"), partial name ("micro"), or ticker fragment, up to 20 characters. Finnhub full-text matches across symbols and descriptions. Use this first when you have a company name, not a ticker — the rest of the tools need a symbol.'),
|
|
17
22
|
limit: z
|
|
18
23
|
.number()
|
|
19
24
|
.int()
|
|
20
25
|
.min(1)
|
|
21
26
|
.max(50)
|
|
22
27
|
.default(10)
|
|
23
|
-
.describe('Max symbols to return (Finnhub often returns 10–50 matches for a common word). Default 10. US Common Stock matches are surfaced first.'),
|
|
28
|
+
.describe('Max symbols to return (Finnhub often returns 10–50 matches for a common word). Default 10. Likely-US Common Stock matches are surfaced first.'),
|
|
24
29
|
}),
|
|
25
30
|
output: z.object({
|
|
26
31
|
results: z
|
|
@@ -38,10 +43,10 @@ export const searchSymbols = tool('finnhub_search_symbols', {
|
|
|
38
43
|
.describe('Security type (e.g., "Common Stock", "ETP", "ETF"). Empty string when Finnhub omits it.'),
|
|
39
44
|
isLikelyUS: z
|
|
40
45
|
.boolean()
|
|
41
|
-
.describe('
|
|
46
|
+
.describe('Symbol-format heuristic for likely US free-tier availability. Plain tickers and `.A`/`.B` class-share symbols are likely US; recognized exchange suffixes such as `.SS`, `.T`, and `.L` are not. Quote and profile responses remain authoritative.'),
|
|
42
47
|
})
|
|
43
48
|
.describe('A single matched symbol.'))
|
|
44
|
-
.describe('Matched symbols, US Common Stock first, then by Finnhub order.'),
|
|
49
|
+
.describe('Matched symbols, likely-US Common Stock first, then by Finnhub order.'),
|
|
45
50
|
}),
|
|
46
51
|
enrichment: {
|
|
47
52
|
totalCount: z
|
|
@@ -62,12 +67,11 @@ export const searchSymbols = tool('finnhub_search_symbols', {
|
|
|
62
67
|
displaySymbol: match.displaySymbol,
|
|
63
68
|
description: match.description,
|
|
64
69
|
type: match.type,
|
|
65
|
-
isLikelyUS: !match.symbol.includes('.'),
|
|
70
|
+
isLikelyUS: !match.symbol.includes('.') || US_CLASS_SHARE_SYMBOL.test(match.symbol),
|
|
66
71
|
}));
|
|
67
72
|
/**
|
|
68
|
-
* Stable sort: US Common Stock first, preserving Finnhub's order
|
|
69
|
-
* each group.
|
|
70
|
-
* exchanges (honest signal, not a fabricated score).
|
|
73
|
+
* Stable sort: likely-US Common Stock first, preserving Finnhub's order
|
|
74
|
+
* within each group. ETFs and ETPs deliberately retain Finnhub's rank.
|
|
71
75
|
*/
|
|
72
76
|
const rank = (r) => r.isLikelyUS && r.type === 'Common Stock' ? 0 : 1;
|
|
73
77
|
const sorted = [...mapped].sort((a, b) => rank(a) - rank(b));
|
|
@@ -91,7 +95,9 @@ export const searchSymbols = tool('finnhub_search_symbols', {
|
|
|
91
95
|
return [{ type: 'text', text: 'No matching symbols.' }];
|
|
92
96
|
}
|
|
93
97
|
const lines = result.results.map((r) => {
|
|
94
|
-
const region = r.isLikelyUS
|
|
98
|
+
const region = r.isLikelyUS
|
|
99
|
+
? 'likely US (symbol heuristic)'
|
|
100
|
+
: 'not likely US (exchange-suffix heuristic)';
|
|
95
101
|
const type = r.type || 'Unknown type';
|
|
96
102
|
return `**${r.symbol}** — ${r.description} (${type}, ${region}) · display: ${r.displaySymbol}`;
|
|
97
103
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"search-symbols.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-symbols.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,wBAAwB,EAAE;IAC1D,WAAW,EACT,
|
|
1
|
+
{"version":3,"file":"search-symbols.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-symbols.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -7,9 +7,9 @@
|
|
|
7
7
|
* identical, correct error semantics.
|
|
8
8
|
* @module services/finnhub/finnhub-service
|
|
9
9
|
*/
|
|
10
|
+
import type { Context } from '@cyanheads/mcp-ts-core';
|
|
10
11
|
import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
|
|
11
12
|
import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
|
|
12
|
-
import type { RequestContextLike } from '@cyanheads/mcp-ts-core/utils';
|
|
13
13
|
import type { FinnhubEarning, FinnhubEarningsCalendar, FinnhubMarketStatus, FinnhubMetricResponse, FinnhubNewsArticle, FinnhubProfile, FinnhubQuote, FinnhubRecommendation, FinnhubSearchResponse } from './types.js';
|
|
14
14
|
/**
|
|
15
15
|
* Authenticated client for the Finnhub REST API. Initialized once in
|
|
@@ -20,27 +20,27 @@ export declare class FinnhubService {
|
|
|
20
20
|
private readonly apiKey;
|
|
21
21
|
constructor();
|
|
22
22
|
/** `GET /search?q={query}` — resolve a name/ticker fragment to symbols. */
|
|
23
|
-
search(query: string, ctx:
|
|
23
|
+
search(query: string, ctx: Context): Promise<FinnhubSearchResponse>;
|
|
24
24
|
/** `GET /quote?symbol={symbol}` — real-time price snapshot. */
|
|
25
|
-
quote(symbol: string, ctx:
|
|
25
|
+
quote(symbol: string, ctx: Context): Promise<FinnhubQuote>;
|
|
26
26
|
/** `GET /stock/market-status?exchange={exchange}` — live market-open flag. */
|
|
27
|
-
marketStatus(exchange: string, ctx:
|
|
27
|
+
marketStatus(exchange: string, ctx: Context): Promise<FinnhubMarketStatus>;
|
|
28
28
|
/** `GET /stock/profile2?symbol={symbol}` — company profile (`{}` if unknown). */
|
|
29
|
-
profile(symbol: string, ctx:
|
|
29
|
+
profile(symbol: string, ctx: Context): Promise<FinnhubProfile>;
|
|
30
30
|
/** `GET /stock/metric?symbol={symbol}&metric=all` — fundamentals (~100 keys). */
|
|
31
|
-
metrics(symbol: string, ctx:
|
|
31
|
+
metrics(symbol: string, ctx: Context): Promise<FinnhubMetricResponse>;
|
|
32
32
|
/** `GET /stock/peers?symbol={symbol}` — sector peer symbols (includes the query). */
|
|
33
|
-
peers(symbol: string, ctx:
|
|
33
|
+
peers(symbol: string, ctx: Context): Promise<string[]>;
|
|
34
34
|
/** `GET /stock/earnings?symbol={symbol}` — past quarters, newest first. */
|
|
35
|
-
earnings(symbol: string, ctx:
|
|
35
|
+
earnings(symbol: string, ctx: Context): Promise<FinnhubEarning[]>;
|
|
36
36
|
/** `GET /calendar/earnings?from={from}&to={to}` — upcoming releases window. */
|
|
37
|
-
earningsCalendar(from: string, to: string, ctx:
|
|
37
|
+
earningsCalendar(from: string, to: string, ctx: Context): Promise<FinnhubEarningsCalendar>;
|
|
38
38
|
/** `GET /company-news?symbol={symbol}&from={from}&to={to}`. */
|
|
39
|
-
companyNews(symbol: string, from: string, to: string, ctx:
|
|
39
|
+
companyNews(symbol: string, from: string, to: string, ctx: Context): Promise<FinnhubNewsArticle[]>;
|
|
40
40
|
/** `GET /news?category={category}` — market-wide headlines. */
|
|
41
|
-
marketNews(category: string, ctx:
|
|
41
|
+
marketNews(category: string, ctx: Context): Promise<FinnhubNewsArticle[]>;
|
|
42
42
|
/** `GET /stock/recommendation?symbol={symbol}` — analyst trends, empty if no coverage. */
|
|
43
|
-
recommendations(symbol: string, ctx:
|
|
43
|
+
recommendations(symbol: string, ctx: Context): Promise<FinnhubRecommendation[]>;
|
|
44
44
|
/**
|
|
45
45
|
* Core request pipeline: build the authenticated URL, fetch, and parse — all
|
|
46
46
|
* wrapped in `withRetry` so transient failures (429/5xx/network) back off and
|