@cyanheads/finnhub-mcp-server 0.1.5 → 0.2.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 (31) hide show
  1. package/AGENTS.md +25 -14
  2. package/CLAUDE.md +25 -14
  3. package/Dockerfile +95 -41
  4. package/README.md +47 -113
  5. package/changelog/0.1.x/0.1.6.md +26 -0
  6. package/changelog/0.2.x/0.2.0.md +35 -0
  7. package/dist/index.js +2 -1
  8. package/dist/index.js.map +1 -1
  9. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +1 -1
  10. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -1
  11. package/dist/mcp-server/tools/definitions/get-company.tool.js +5 -3
  12. package/dist/mcp-server/tools/definitions/get-company.tool.js.map +1 -1
  13. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts.map +1 -1
  14. package/dist/mcp-server/tools/definitions/get-earnings.tool.js +4 -2
  15. package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -1
  16. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts.map +1 -1
  17. package/dist/mcp-server/tools/definitions/get-news.tool.js +3 -1
  18. package/dist/mcp-server/tools/definitions/get-news.tool.js.map +1 -1
  19. package/dist/mcp-server/tools/definitions/get-quote.tool.d.ts.map +1 -1
  20. package/dist/mcp-server/tools/definitions/get-quote.tool.js +4 -2
  21. package/dist/mcp-server/tools/definitions/get-quote.tool.js.map +1 -1
  22. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts +1 -1
  23. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts.map +1 -1
  24. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js +7 -5
  25. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -1
  26. package/dist/mcp-server/tools/definitions/index.d.ts +47 -47
  27. package/dist/services/finnhub/finnhub-service.d.ts +1 -1
  28. package/dist/services/finnhub/finnhub-service.js +1 -1
  29. package/package.json +13 -11
  30. package/server.json +10 -24
  31. package/skills/finnhub-guide/SKILL.md +31 -0
@@ -1 +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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"}
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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"}
@@ -23,7 +23,7 @@ export declare const getRecommendations: import("@cyanheads/mcp-ts-core").ToolDe
23
23
  readonly reason: "no_coverage";
24
24
  readonly code: JsonRpcErrorCode.NotFound;
25
25
  readonly when: "Endpoint returned an empty array — no analyst coverage for the symbol.";
26
- readonly recovery: "Verify the symbol is valid with finnhub_search_symbols; some thinly-traded or newly-listed stocks have no analyst coverage on Finnhub.";
26
+ readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.";
27
27
  }, {
28
28
  readonly reason: "not_us_or_paid";
29
29
  readonly code: JsonRpcErrorCode.Forbidden;
@@ -1 +1 @@
1
- {"version":3,"file":"get-recommendations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsH7B,CAAC"}
1
+ {"version":3,"file":"get-recommendations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwH7B,CAAC"}
@@ -13,18 +13,20 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
13
13
  input: z.object({
14
14
  symbol: z
15
15
  .string()
16
+ .trim()
17
+ .toUpperCase()
16
18
  .min(1)
17
- .describe('US stock ticker (e.g., "AAPL"). Resolve a name with finnhub_search_symbols first.'),
19
+ .describe('US stock ticker (e.g., "AAPL"), trimmed and uppercased with punctuation preserved. Resolve a name with finnhub_search_symbols first.'),
18
20
  limit: z
19
21
  .number()
20
22
  .int()
21
23
  .min(1)
22
24
  .max(24)
23
25
  .default(12)
24
- .describe('Max months to return, newest first. Default 12 (one year of consensus history). The API typically returns 12–24 months; setting this higher surfaces older trend data.'),
26
+ .describe('Maximum months to return from available upstream history, newest first (1–24, default 12). Increasing the limit returns more available rows, not history absent from Finnhub.'),
25
27
  }),
26
28
  output: z.object({
27
- symbol: z.string().describe('The symbol queried (echo of input).'),
29
+ symbol: z.string().describe('The symbol queried, trimmed and uppercased.'),
28
30
  trends: z
29
31
  .array(z
30
32
  .object({
@@ -40,7 +42,7 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
40
42
  .describe('Number of analysts with a Strong Sell rating this month.'),
41
43
  })
42
44
  .describe('One month of analyst recommendation counts.'))
43
- .describe('Recommendation counts per month, newest first. Typically 12–24 months of history.'),
45
+ .describe('Recommendation counts per month, newest first. History depth depends on Finnhub coverage.'),
44
46
  }),
45
47
  enrichment: {
46
48
  totalCount: z.number().describe('Total months available before the limit.'),
@@ -53,7 +55,7 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
53
55
  reason: 'no_coverage',
54
56
  code: JsonRpcErrorCode.NotFound,
55
57
  when: 'Endpoint returned an empty array — no analyst coverage for the symbol.',
56
- recovery: 'Verify the symbol is valid with finnhub_search_symbols; some thinly-traded or newly-listed stocks have no analyst coverage on Finnhub.',
58
+ recovery: 'Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.',
57
59
  },
58
60
  {
59
61
  reason: 'not_us_or_paid',
@@ -1 +1 @@
1
- {"version":3,"file":"get-recommendations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"get-recommendations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"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"}
@@ -4,51 +4,6 @@
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
7
  query: import("zod").ZodString;
53
8
  limit: import("zod").ZodDefault<import("zod").ZodNumber>;
54
9
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
@@ -129,7 +84,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
129
84
  readonly reason: "symbol_not_found";
130
85
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
131
86
  readonly when: "/stock/profile2 returned an empty object for the symbol.";
132
- readonly recovery: "Verify the ticker, or call finnhub_search_symbols to resolve the company name first.";
87
+ readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack company profiles; try finnhub_get_quote for price data.";
133
88
  }, {
134
89
  readonly reason: "not_us_or_paid";
135
90
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
@@ -183,6 +138,51 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
183
138
  readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
184
139
  readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
185
140
  readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
141
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
142
+ mode: import("zod").ZodEnum<{
143
+ company: "company";
144
+ market: "market";
145
+ }>;
146
+ symbol: import("zod").ZodOptional<import("zod").ZodString>;
147
+ from: import("zod").ZodOptional<import("zod").ZodString>;
148
+ to: import("zod").ZodOptional<import("zod").ZodString>;
149
+ category: import("zod").ZodDefault<import("zod").ZodEnum<{
150
+ crypto: "crypto";
151
+ forex: "forex";
152
+ general: "general";
153
+ merger: "merger";
154
+ }>>;
155
+ limit: import("zod").ZodDefault<import("zod").ZodNumber>;
156
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
157
+ mode: import("zod").ZodEnum<{
158
+ company: "company";
159
+ market: "market";
160
+ }>;
161
+ articles: import("zod").ZodArray<import("zod").ZodObject<{
162
+ headline: import("zod").ZodString;
163
+ source: import("zod").ZodString;
164
+ datetime: import("zod").ZodString;
165
+ summary: import("zod").ZodString;
166
+ url: import("zod").ZodString;
167
+ category: import("zod").ZodOptional<import("zod").ZodString>;
168
+ related: import("zod").ZodOptional<import("zod").ZodString>;
169
+ }, import("zod/v4/core").$strip>>;
170
+ }, import("zod/v4/core").$strip>, readonly [{
171
+ readonly reason: "missing_symbol";
172
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
173
+ readonly when: "mode 'company' was requested without a symbol.";
174
+ readonly recovery: "Provide a `symbol` for company mode, or switch to mode: market with a category.";
175
+ }, {
176
+ readonly reason: "not_us_or_paid";
177
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
178
+ readonly when: "Upstream HTTP 403 on the symbol.";
179
+ readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
180
+ }], {
181
+ readonly totalCount: import("zod").ZodNumber;
182
+ readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
183
+ readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
184
+ readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
185
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
186
186
  }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
187
187
  symbol: import("zod").ZodString;
188
188
  limit: import("zod").ZodDefault<import("zod").ZodNumber>;
@@ -200,7 +200,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
200
200
  readonly reason: "no_coverage";
201
201
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
202
202
  readonly when: "Endpoint returned an empty array — no analyst coverage for the symbol.";
203
- readonly recovery: "Verify the symbol is valid with finnhub_search_symbols; some thinly-traded or newly-listed stocks have no analyst coverage on Finnhub.";
203
+ readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.";
204
204
  }, {
205
205
  readonly reason: "not_us_or_paid";
206
206
  readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
@@ -47,7 +47,7 @@ export declare class FinnhubService {
47
47
  * retry while deterministic failures (401/403) fail fast.
48
48
  *
49
49
  * `fetchWithTimeout` throws a classified `McpError` on any non-OK status and
50
- * reduces URLs in errors/logs to origin + pathname, so the `token` query
50
+ * reduces URLs in errors/logs to their origin, so the `token` query
51
51
  * param never reaches a client or a log line. Its default status mapping
52
52
  * matches the design for 403 (→ `Forbidden`), 429 (→ `RateLimited`), and 5xx
53
53
  * (→ `ServiceUnavailable`); only 401 is re-keyed below from `Unauthorized` to
@@ -80,7 +80,7 @@ export class FinnhubService {
80
80
  * retry while deterministic failures (401/403) fail fast.
81
81
  *
82
82
  * `fetchWithTimeout` throws a classified `McpError` on any non-OK status and
83
- * reduces URLs in errors/logs to origin + pathname, so the `token` query
83
+ * reduces URLs in errors/logs to their origin, so the `token` query
84
84
  * param never reaches a client or a log line. Its default status mapping
85
85
  * matches the design for 403 (→ `Forbidden`), 429 (→ `RateLimited`), and 5xx
86
86
  * (→ `ServiceUnavailable`); only 401 is re-keyed below from `Unauthorized` to
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cyanheads/finnhub-mcp-server",
3
- "version": "0.1.5",
3
+ "version": "0.2.0",
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",
@@ -11,7 +11,9 @@
11
11
  },
12
12
  "files": [
13
13
  "changelog/",
14
+ "skills/",
14
15
  "dist/",
16
+ "!dist/*.mcpb",
15
17
  "README.md",
16
18
  "LICENSE",
17
19
  "CLAUDE.md",
@@ -70,7 +72,7 @@
70
72
  "url": "https://github.com/cyanheads/finnhub-mcp-server/issues"
71
73
  },
72
74
  "license": "Apache-2.0",
73
- "packageManager": "bun@1.4.0",
75
+ "packageManager": "bun@1.4.4",
74
76
  "author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
75
77
  "engines": {
76
78
  "bun": ">=1.4.0",
@@ -90,18 +92,18 @@
90
92
  "access": "public"
91
93
  },
92
94
  "dependencies": {
93
- "@cyanheads/mcp-ts-core": "^0.13.6",
94
- "pino-pretty": "^13.1.3",
95
- "zod": "^4.6.5"
95
+ "@cyanheads/mcp-ts-core": "^0.13.18",
96
+ "pino-pretty": "^13.2.0",
97
+ "zod": "^4.6.7"
96
98
  },
97
99
  "devDependencies": {
98
- "@biomejs/biome": "2.5.14",
99
- "@socketsecurity/bun-security-scanner": "^1.1.2",
100
- "@types/node": "26.6.1",
100
+ "@biomejs/biome": "2.6.4",
101
+ "@socketsecurity/bun-security-scanner": "^1.1.3",
102
+ "@types/node": "26.6.6",
101
103
  "depcheck": "^1.4.7",
102
- "ignore": "^7.0.9",
103
- "tsc-alias": "^1.9.5",
104
+ "ignore": "^7.0.14",
105
+ "tsc-alias": "^1.9.9",
104
106
  "typescript": "^7.0.2",
105
- "vitest": "^5.0.1"
107
+ "vitest": "^5.0.5"
106
108
  }
107
109
  }
package/server.json CHANGED
@@ -6,24 +6,14 @@
6
6
  "url": "https://github.com/cyanheads/finnhub-mcp-server",
7
7
  "source": "github"
8
8
  },
9
- "version": "0.1.5",
9
+ "version": "0.2.0",
10
10
  "packages": [
11
11
  {
12
12
  "registryType": "npm",
13
13
  "registryBaseUrl": "https://registry.npmjs.org",
14
14
  "identifier": "@cyanheads/finnhub-mcp-server",
15
- "runtimeHint": "node",
16
- "version": "0.1.5",
17
- "packageArguments": [
18
- {
19
- "type": "positional",
20
- "value": "run"
21
- },
22
- {
23
- "type": "positional",
24
- "value": "start:stdio"
25
- }
26
- ],
15
+ "runtimeHint": "npx",
16
+ "version": "0.2.0",
27
17
  "environmentVariables": [
28
18
  {
29
19
  "name": "FINNHUB_API_KEY",
@@ -54,19 +44,15 @@
54
44
  "registryType": "npm",
55
45
  "registryBaseUrl": "https://registry.npmjs.org",
56
46
  "identifier": "@cyanheads/finnhub-mcp-server",
57
- "runtimeHint": "node",
58
- "version": "0.1.5",
59
- "packageArguments": [
47
+ "runtimeHint": "npx",
48
+ "version": "0.2.0",
49
+ "environmentVariables": [
60
50
  {
61
- "type": "positional",
62
- "value": "run"
51
+ "name": "MCP_TRANSPORT_TYPE",
52
+ "description": "Selects the HTTP transport.",
53
+ "format": "string",
54
+ "value": "http"
63
55
  },
64
- {
65
- "type": "positional",
66
- "value": "start:http"
67
- }
68
- ],
69
- "environmentVariables": [
70
56
  {
71
57
  "name": "FINNHUB_API_KEY",
72
58
  "description": "Required. Free Finnhub API key from https://finnhub.io/register (Dashboard → API key). Free tier: 60 req/min, US real-time.",
@@ -0,0 +1,31 @@
1
+ ---
2
+ name: finnhub-guide
3
+ description: Build company and earnings briefings with finnhub_* tools, preserving security identity, quote freshness, and endpoint coverage. Use when combining prices, fundamentals, earnings, news, or analyst recommendations, or investigating missing data across these tools.
4
+ license: Apache-2.0
5
+ metadata:
6
+ author: "cyanheads"
7
+ version: "1.0"
8
+ ---
9
+
10
+ ## Scope
11
+
12
+ Use Finnhub for current equity context and financial news. This surface does not provide historical price candles or FX rates; forex and crypto news categories do not imply pricing tools.
13
+
14
+ ## Identifiers
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.
17
+
18
+ ## Gates
19
+
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
+ - 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
+ - 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.
24
+
25
+ ## Workflows
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.
28
+
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
+
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.