@cyanheads/finnhub-mcp-server 0.1.6 → 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 (55) hide show
  1. package/AGENTS.md +21 -9
  2. package/CLAUDE.md +21 -9
  3. package/Dockerfile +7 -3
  4. package/README.md +46 -101
  5. package/changelog/0.2.x/0.2.0.md +35 -0
  6. package/changelog/0.2.x/0.2.1.md +35 -0
  7. package/changelog/template.md +10 -3
  8. package/dist/index.js +2 -1
  9. package/dist/index.js.map +1 -1
  10. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +12 -2
  11. package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -1
  12. package/dist/mcp-server/tools/definitions/get-company.tool.js +16 -8
  13. package/dist/mcp-server/tools/definitions/get-company.tool.js.map +1 -1
  14. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts +25 -2
  15. package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts.map +1 -1
  16. package/dist/mcp-server/tools/definitions/get-earnings.tool.js +88 -42
  17. package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -1
  18. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts +16 -0
  19. package/dist/mcp-server/tools/definitions/get-news.tool.d.ts.map +1 -1
  20. package/dist/mcp-server/tools/definitions/get-news.tool.js +90 -34
  21. package/dist/mcp-server/tools/definitions/get-news.tool.js.map +1 -1
  22. package/dist/mcp-server/tools/definitions/get-quote.tool.d.ts.map +1 -1
  23. package/dist/mcp-server/tools/definitions/get-quote.tool.js +4 -2
  24. package/dist/mcp-server/tools/definitions/get-quote.tool.js.map +1 -1
  25. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts +1 -1
  26. package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts.map +1 -1
  27. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js +7 -6
  28. package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -1
  29. package/dist/mcp-server/tools/definitions/index.d.ts +93 -42
  30. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  31. package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts +2 -0
  32. package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts.map +1 -1
  33. package/dist/mcp-server/tools/definitions/search-symbols.tool.js +28 -18
  34. package/dist/mcp-server/tools/definitions/search-symbols.tool.js.map +1 -1
  35. package/dist/mcp-server/tools/definitions/window-page.d.ts +21 -0
  36. package/dist/mcp-server/tools/definitions/window-page.d.ts.map +1 -0
  37. package/dist/mcp-server/tools/definitions/window-page.js +39 -0
  38. package/dist/mcp-server/tools/definitions/window-page.js.map +1 -0
  39. package/dist/services/finnhub/date-window.d.ts +13 -0
  40. package/dist/services/finnhub/date-window.d.ts.map +1 -0
  41. package/dist/services/finnhub/date-window.js +32 -0
  42. package/dist/services/finnhub/date-window.js.map +1 -0
  43. package/dist/services/finnhub/finnhub-service.d.ts +4 -4
  44. package/dist/services/finnhub/finnhub-service.d.ts.map +1 -1
  45. package/dist/services/finnhub/finnhub-service.js +6 -6
  46. package/dist/services/finnhub/finnhub-service.js.map +1 -1
  47. package/dist/services/finnhub/normalize-article-text.d.ts +6 -0
  48. package/dist/services/finnhub/normalize-article-text.d.ts.map +1 -0
  49. package/dist/services/finnhub/normalize-article-text.js +97 -0
  50. package/dist/services/finnhub/normalize-article-text.js.map +1 -0
  51. package/dist/services/finnhub/types.d.ts +3 -3
  52. package/dist/services/finnhub/types.d.ts.map +1 -1
  53. package/package.json +15 -11
  54. package/server.json +3 -3
  55. package/skills/finnhub-guide/SKILL.md +31 -0
package/AGENTS.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** finnhub-mcp-server
4
- **Version:** 0.1.6
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.13`
6
- **Engines:** Bun ≥1.4.0, Node ≥24.0.0
7
- **MCP SDK:** `@modelcontextprotocol/server` 2.2.0
8
- **Zod:** ^4.6.5
4
+ **Version:** 0.2.1
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.22`
6
+ **Engines:** Bun ≥1.4.4, Node ≥24.0.0
7
+ **MCP SDK:** `@modelcontextprotocol/server` 2.4.0
8
+ **Zod:** ^4.6.7
9
9
 
10
10
  > **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
11
11
 
@@ -258,9 +258,18 @@ src/
258
258
 
259
259
  ## Skills
260
260
 
261
- Skills are modular instructions in `framework-skills/` at the project root. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. The directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand these development skills to every agent that installs it. Keep `skills/` free for skills meant for those agents.
261
+ Two skill trees live at the project root, written for different readers:
262
262
 
263
- **Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `framework-skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
263
+ | Tree | For | Written by |
264
+ |:-----|:----|:-----------|
265
+ | `framework-skills/` | The agent developing this server — framework skills (`metadata.audience: external`) plus any development-time skills of the server's own | `init` and the `maintenance` sync (framework skills); you (your own) |
266
+ | `skills/` | The agents that install the server and call its tools — tool chains, identifier sources, gates | You, deliberately, with the `add-skill` skill. Absent by default; usually none is needed |
267
+
268
+ Development skills are modular instructions. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. Their directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand them to every agent that installs it.
269
+
270
+ A published skill in root `skills/` reaches plugin installs and the `.mcpb` bundle as-is, ships in the npm package and the Docker image, and reaches MCP clients when the server opts in with `createApp({ skills: 'skills' })`. `lint:packaging` validates the tree.
271
+
272
+ **Agent skill directory:** Copy `framework-skills/` into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `framework-skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
264
273
 
265
274
  Available skills:
266
275
 
@@ -272,6 +281,7 @@ Available skills:
272
281
  | `add-app-tool` | Scaffold an MCP App tool + paired UI resource |
273
282
  | `add-resource` | Scaffold a new resource definition |
274
283
  | `add-prompt` | Scaffold a new prompt definition |
284
+ | `add-skill` | Author a skill the server publishes in root `skills/` for the agents that use it — when one earns its place, structure, validation, delivery |
275
285
  | `add-service` | Scaffold a new service integration |
276
286
  | `add-test` | Scaffold test file for a tool, resource, or service |
277
287
  | `field-test` | Exercise tools/resources/prompts with real inputs, verify behavior, report issues |
@@ -317,7 +327,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
317
327
  | `bun run clean` | Remove build artifacts |
318
328
  | `bun run devcheck` | Lint + format + typecheck + security + changelog sync |
319
329
  | `bun run lint:mcp` | Run the MCP definition linter standalone (rule catalog: `api-linter` skill) |
320
- | `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |
330
+ | `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity, `.mcpbignore` coverage, plugin manifests, and the published `skills/` tree (run by devcheck) |
321
331
  | `bun run list-skills` | Print the skill registry |
322
332
  | `bun run audit:fix` | `bun audit fix` — upgrade vulnerable packages to the lowest safe version within existing ranges (`--dry-run` previews, `--latest` rewrites ranges). First response when `devcheck` flags a transitive advisory; then `bun update <name>`, then `bun dedupe` |
323
333
  | `bun run audit:refresh` | Delete `bun.lock` and reinstall. Last resort after `audit:fix`, `bun update <name>`, and `bun dedupe` — re-resolves every ranged dep (the framework pin included) and rewrites the lockfile as `lockfileVersion: 2` |
@@ -337,7 +347,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
337
347
 
338
348
  ## Bundling
339
349
 
340
- `bun run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
350
+ `npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs — `framework-skills/`, `skills/`, `.claude/`, `.agents/`, `AGENTS.md`, and `CLAUDE.md` at a package's root, and `SKILL.md` anywhere (a `skills/` deeper in a package is runtime code and stays); platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates/`, and config bases (`biome.json`, `vitest.config.base.mjs`, `config/tsconfig.base.json`), and `better-sqlite3`'s `deps/` and `src/` C sources. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
341
351
 
342
352
  **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
343
353
 
@@ -404,7 +414,9 @@ import { getMyService } from '@/services/my-domain/my-service.js';
404
414
  - [ ] If wrapping external API: tests include at least one sparse payload case with omitted upstream fields
405
415
  - [ ] Registered in `createApp()` arrays (directly or via barrel exports)
406
416
  - [ ] Tests use `createMockContext()` from `@cyanheads/mcp-ts-core/testing`
417
+ - [ ] Root `plugin.json` and `mcp.json` match the package metadata and fixed stdio configuration. User-supplied variables are forwarded through the `.codex-plugin/mcp.json` `env_vars` overlay, referenced by `.codex-plugin/plugin.json`.
407
418
  - [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = the unscoped repo name (never the npm scope — `lint:packaging` enforces this); `interface.shortDescription` from `package.json` description
408
419
  - [ ] `.codex-plugin/mcp.json` updated — server name key is the unscoped repo name; every user-supplied variable (API key, contact email, instance URL) is listed in `env_vars` so Codex forwards it from the user's environment. Never write `"KEY": ""` into `env` — an empty value replaces the user's exported key and is read as unset
409
420
  - [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `author`, `repository`, `license`, `keywords` from `package.json`; inline `mcpServers` entry keyed by the unscoped repo name. Every user-supplied variable is declared under `userConfig` (`type`, `title`, `description`; `sensitive: true` for keys and tokens; `required: true` or `default: ""`) and referenced from `env` as `"KEY": "${user_config.<option>}"` — mirror the `user_config` block in `manifest.json`. Never write `"KEY": ""` into `env`
410
421
  - [ ] `npm run devcheck` passes
422
+ - [ ] New root development paths have anchored `.mcpbignore` entries. Run `bun run bundle` and `bun run lint:packaging` when changing the bundle.
package/CLAUDE.md CHANGED
@@ -1,11 +1,11 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** finnhub-mcp-server
4
- **Version:** 0.1.6
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.13`
6
- **Engines:** Bun ≥1.4.0, Node ≥24.0.0
7
- **MCP SDK:** `@modelcontextprotocol/server` 2.2.0
8
- **Zod:** ^4.6.5
4
+ **Version:** 0.2.1
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.22`
6
+ **Engines:** Bun ≥1.4.4, Node ≥24.0.0
7
+ **MCP SDK:** `@modelcontextprotocol/server` 2.4.0
8
+ **Zod:** ^4.6.7
9
9
 
10
10
  > **Read the framework docs first:** `node_modules/@cyanheads/mcp-ts-core/CLAUDE.md` contains the full API reference — builders, Context, error codes, exports, patterns. This file covers server-specific conventions only.
11
11
 
@@ -258,9 +258,18 @@ src/
258
258
 
259
259
  ## Skills
260
260
 
261
- Skills are modular instructions in `framework-skills/` at the project root. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. The directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand these development skills to every agent that installs it. Keep `skills/` free for skills meant for those agents.
261
+ Two skill trees live at the project root, written for different readers:
262
262
 
263
- **Agent skill directory:** Copy skills into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `framework-skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
263
+ | Tree | For | Written by |
264
+ |:-----|:----|:-----------|
265
+ | `framework-skills/` | The agent developing this server — framework skills (`metadata.audience: external`) plus any development-time skills of the server's own | `init` and the `maintenance` sync (framework skills); you (your own) |
266
+ | `skills/` | The agents that install the server and call its tools — tool chains, identifier sources, gates | You, deliberately, with the `add-skill` skill. Absent by default; usually none is needed |
267
+
268
+ Development skills are modular instructions. Read them directly when a task matches — e.g., `framework-skills/add-tool/SKILL.md` when adding a tool. `bun run list-skills` prints the full registry. Their directory is deliberately not `skills/`: Claude Code and Codex auto-load a plugin's root `skills/`, so a server that ships `.claude-plugin/` or `.codex-plugin/` would hand them to every agent that installs it.
269
+
270
+ A published skill in root `skills/` reaches plugin installs and the `.mcpb` bundle as-is, ships in the npm package and the Docker image, and reaches MCP clients when the server opts in with `createApp({ skills: 'skills' })`. `lint:packaging` validates the tree.
271
+
272
+ **Agent skill directory:** Copy `framework-skills/` into the directory your agent discovers (Claude Code: `.claude/skills/`, others: equivalent). Skills then load as context without referencing `framework-skills/` paths. After framework updates, run the `maintenance` skill — Phase B re-syncs the agent directory.
264
273
 
265
274
  Available skills:
266
275
 
@@ -272,6 +281,7 @@ Available skills:
272
281
  | `add-app-tool` | Scaffold an MCP App tool + paired UI resource |
273
282
  | `add-resource` | Scaffold a new resource definition |
274
283
  | `add-prompt` | Scaffold a new prompt definition |
284
+ | `add-skill` | Author a skill the server publishes in root `skills/` for the agents that use it — when one earns its place, structure, validation, delivery |
275
285
  | `add-service` | Scaffold a new service integration |
276
286
  | `add-test` | Scaffold test file for a tool, resource, or service |
277
287
  | `field-test` | Exercise tools/resources/prompts with real inputs, verify behavior, report issues |
@@ -317,7 +327,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
317
327
  | `bun run clean` | Remove build artifacts |
318
328
  | `bun run devcheck` | Lint + format + typecheck + security + changelog sync |
319
329
  | `bun run lint:mcp` | Run the MCP definition linter standalone (rule catalog: `api-linter` skill) |
320
- | `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity (run by devcheck) |
330
+ | `bun run lint:packaging` | Packaging surface checks — `server.json`/`manifest.json` env-var parity, `.mcpbignore` coverage, plugin manifests, and the published `skills/` tree (run by devcheck) |
321
331
  | `bun run list-skills` | Print the skill registry |
322
332
  | `bun run audit:fix` | `bun audit fix` — upgrade vulnerable packages to the lowest safe version within existing ranges (`--dry-run` previews, `--latest` rewrites ranges). First response when `devcheck` flags a transitive advisory; then `bun update <name>`, then `bun dedupe` |
323
333
  | `bun run audit:refresh` | Delete `bun.lock` and reinstall. Last resort after `audit:fix`, `bun update <name>`, and `bun dedupe` — re-resolves every ranged dep (the framework pin included) and rewrites the lockfile as `lockfileVersion: 2` |
@@ -337,7 +347,7 @@ When you complete a skill's checklist, check the boxes and add a completion time
337
347
 
338
348
  ## Bundling
339
349
 
340
- `bun run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips two classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs (`framework-skills/`, `skills/`, `.claude/`, `.agents/`, `SKILL.md`) and platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
350
+ `npm run bundle` produces a `.mcpb` extension bundle for one-click install in Claude Desktop. `mcpb pack` reads `.mcpbignore`, not `.gitignore`, so every root path the bundle must not ship — source, tests, docs, caches, logs, agent docs, plugin manifests, gitignored local files — needs a root-anchored line there (`/docs/`, never `docs/`, which also strips `node_modules/*/docs/`); `lint:packaging` names each missing or unanchored line. Root `skills/` ships on purpose. The pack step is followed by `scripts/clean-mcpb.ts`, which prunes dev dependencies (`mcpb clean`) and strips four classes of `node_modules/**` content that root-anchored `.mcpbignore` patterns cannot reach: dependency-shipped agent docs — `framework-skills/`, `skills/`, `.claude/`, `.agents/`, `AGENTS.md`, and `CLAUDE.md` at a package's root, and `SKILL.md` anywhere (a `skills/` deeper in a package is runtime code and stays); platform-specific native bindings, which would otherwise lock the bundle to the platform it was packed on; node-gyp build output beside a `binding.gyp` (`config.gypi`, Makefiles, `obj.target/`, `.deps/`, object files and debug symbols), which records the packing machine's paths — compiled `*.node` addons stay; and build-only package files — the framework's `changelog/`, `scripts/`, `templates/`, and config bases (`biome.json`, `vitest.config.base.mjs`, `config/tsconfig.base.json`), and `better-sqlite3`'s `deps/` and `src/` C sources. A server using DataCanvas therefore ships a portable bundle without the DuckDB native — `@duckdb/node-api` is an optional peer loaded lazily, so canvas tools report an actionable install hint and every other tool works normally. MCPB is stdio-only — HTTP and Cloudflare Workers deployments are unaffected. Consumers who don't need it can delete `manifest.json` and `.mcpbignore`; `lint:packaging` skips cleanly.
341
351
 
342
352
  **Adding an env var requires both files:** `server.json` (registry discovery, `environmentVariables[]`) and `manifest.json` (bundle install UX, `mcp_config.env` + `user_config`). `lint:packaging` (run by `devcheck`) verifies the env var names match, that every `user_config` option is wired into `mcp_config.env` as `"X": "${user_config.X}"` (the host substitutes nothing else — `"${X}"` reaches the server as that literal string), and that an optional string option carries `"default": ""`.
343
353
 
@@ -404,7 +414,9 @@ import { getMyService } from '@/services/my-domain/my-service.js';
404
414
  - [ ] If wrapping external API: tests include at least one sparse payload case with omitted upstream fields
405
415
  - [ ] Registered in `createApp()` arrays (directly or via barrel exports)
406
416
  - [ ] Tests use `createMockContext()` from `@cyanheads/mcp-ts-core/testing`
417
+ - [ ] Root `plugin.json` and `mcp.json` match the package metadata and fixed stdio configuration. User-supplied variables are forwarded through the `.codex-plugin/mcp.json` `env_vars` overlay, referenced by `.codex-plugin/plugin.json`.
407
418
  - [ ] `.codex-plugin/plugin.json` populated — `name`, `version`, `description`, `repository`, `license` from `package.json`; `interface.displayName` = the unscoped repo name (never the npm scope — `lint:packaging` enforces this); `interface.shortDescription` from `package.json` description
408
419
  - [ ] `.codex-plugin/mcp.json` updated — server name key is the unscoped repo name; every user-supplied variable (API key, contact email, instance URL) is listed in `env_vars` so Codex forwards it from the user's environment. Never write `"KEY": ""` into `env` — an empty value replaces the user's exported key and is read as unset
409
420
  - [ ] `.claude-plugin/plugin.json` populated — `name`, `version`, `description`, `author`, `repository`, `license`, `keywords` from `package.json`; inline `mcpServers` entry keyed by the unscoped repo name. Every user-supplied variable is declared under `userConfig` (`type`, `title`, `description`; `sensitive: true` for keys and tokens; `required: true` or `default: ""`) and referenced from `env` as `"KEY": "${user_config.<option>}"` — mirror the `user_config` block in `manifest.json`. Never write `"KEY": ""` into `env`
410
421
  - [ ] `npm run devcheck` passes
422
+ - [ ] New root development paths have anchored `.mcpbignore` entries. Run `bun run bundle` and `bun run lint:packaging` when changing the bundle.
package/Dockerfile CHANGED
@@ -14,7 +14,7 @@
14
14
  # output. A stage that compiles a native addon needs the target-arch toolchain
15
15
  # and cannot cross-compile this way — drop the flag there.
16
16
  # ==============================================================================
17
- FROM --platform=$BUILDPLATFORM oven/bun:1.4.2 AS build
17
+ FROM --platform=$BUILDPLATFORM oven/bun:1.4.4 AS build
18
18
 
19
19
  WORKDIR /usr/src/app
20
20
 
@@ -29,6 +29,9 @@ RUN --mount=type=cache,target=/root/.bun/install/cache \
29
29
  # Copy the rest of the source code
30
30
  COPY . .
31
31
 
32
+ # Published skills are read from the application root at runtime.
33
+ RUN mkdir -p skills
34
+
32
35
  # Build the application
33
36
  RUN bun run build
34
37
 
@@ -46,7 +49,7 @@ RUN bun run build
46
49
  # A clean image rather than `FROM build`: the build stage's node_modules holds
47
50
  # devDependencies.
48
51
  # ==============================================================================
49
- FROM --platform=$BUILDPLATFORM oven/bun:1.4.2 AS deps
52
+ FROM --platform=$BUILDPLATFORM oven/bun:1.4.4 AS deps
50
53
 
51
54
  WORKDIR /usr/src/app
52
55
 
@@ -114,7 +117,7 @@ RUN rm -rf node_modules/@socketsecurity/bun-security-scanner
114
117
  # dependencies and build artifacts. Its only Bun invocations are HEALTHCHECK
115
118
  # and CMD, which run on the real target at container start.
116
119
  # ==============================================================================
117
- FROM oven/bun:1.4.2-slim AS production
120
+ FROM oven/bun:1.4.4-slim AS production
118
121
 
119
122
  WORKDIR /usr/src/app
120
123
 
@@ -136,6 +139,7 @@ COPY --from=deps /usr/src/app/node_modules ./node_modules
136
139
 
137
140
  # Copy the compiled application code from the build stage
138
141
  COPY --from=build /usr/src/app/dist ./dist
142
+ COPY --from=build /usr/src/app/skills ./skills
139
143
 
140
144
  # Mirror CLI (MirrorService adopters only — Tier 3, opt-in):
141
145
  # Copy your mirror lifecycle scripts and emit a runtime tsconfig so Bun resolves
package/README.md CHANGED
@@ -1,13 +1,13 @@
1
1
  <div align="center">
2
2
  <h1>@cyanheads/finnhub-mcp-server</h1>
3
3
  <p><b>Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.</b>
4
- <div>6 Tools • 1 Resource</div>
4
+ <div>6 Tools • 2 Resources</div>
5
5
  </p>
6
6
  </div>
7
7
 
8
8
  <div align="center">
9
9
 
10
- [![Version](https://img.shields.io/badge/Version-0.1.6-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/finnhub-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.2.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/finnhub-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/finnhub-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.2-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.2.1-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/finnhub-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.4.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/finnhub-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/finnhub-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.4-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
11
 
12
12
  </div>
13
13
 
@@ -23,16 +23,18 @@
23
23
 
24
24
  ## Overview
25
25
 
26
- Real-time US-equity data from Finnhub — quotes, company fundamentals, earnings, analyst recommendations, and financial news. Resolve a company name to a symbol with `finnhub_search_symbols`, then pull live pricing, valuation, or news for it from any MCP client. Runs as a stdio process or a local Streamable HTTP server.
26
+ Real-time US stock data from Finnhub: quotes, company fundamentals, earnings, analyst recommendations, and financial news. Look up a company by name, then pull live pricing, valuation, or news for it.
27
+
28
+ Ticker inputs are trimmed and uppercased; punctuation such as `BRK.B` is preserved. Earnings calendar filters may be omitted or blank for market-wide results; earnings history and company news require a nonblank symbol. Search queries retain their original spelling, and market news ignores `symbol`.
27
29
 
28
30
  ### Tools
29
31
 
30
32
  | Tool | Description |
31
33
  |:---|:---|
32
- | `finnhub_search_symbols` | Resolve a company name or partial ticker to stock symbols, best likely-US match first. The entry point for every other tool. |
34
+ | `finnhub_search_symbols` | Resolve a company name or ticker, optionally within one exchange. Exact ticker matches rank first. |
33
35
  | `finnhub_get_quote` | Real-time price quote for one US symbol, paired with live market-status so the response states whether the price is live or the prior close, including the returned session and named holiday. |
34
- | `finnhub_get_company` | Full company context in one call — profile, headline fundamentals (P/E, EPS, margins, growth), and sector peers. |
35
- | `finnhub_get_earnings` | Earnings in two modes: a symbol's past quarters with actual-vs-estimate surprises (`history`), or upcoming releases in a date window with an optional symbol filter (`calendar`). |
36
+ | `finnhub_get_company` | Get a company profile, headline fundamentals, and peers grouped by sub-industry, industry, or sector. |
37
+ | `finnhub_get_earnings` | Get quarterly EPS surprises or a calendar of releases with EPS and revenue estimates and reported actuals where available. |
36
38
  | `finnhub_get_news` | Financial news in two modes: recent articles for one symbol over a date range (`company`), or broad market headlines by category (`market`). |
37
39
  | `finnhub_get_recommendations` | Analyst recommendation trends for one US symbol — strong-buy / buy / hold / sell / strong-sell counts per month, newest first. |
38
40
 
@@ -41,15 +43,17 @@ Real-time US-equity data from Finnhub — quotes, company fundamentals, earnings
41
43
  | Resource | Description |
42
44
  |:---|:---|
43
45
  | `finnhub://news-categories` | The four valid market-news categories (`general`, `forex`, `crypto`, `merger`) with one-line descriptions. |
46
+ | `skill://finnhub-guide/SKILL.md` | Agent guide for company and earnings briefings, security identity, quote freshness, and coverage gaps. |
44
47
 
45
- Fully covered by the `category` enum on `finnhub_get_news`, so tool-only clients lose nothing.
48
+ The news-category reference mirrors the `category` enum on `finnhub_get_news`. The [finnhub guide](./skills/finnhub-guide/SKILL.md) also ships with plugin installs, npm, Docker, and the desktop bundle.
46
49
 
47
50
  ## Capability reference
48
51
 
49
52
  ### `finnhub_search_symbols` <sub>tool</sub>
50
53
 
51
54
  - Search by company name or ticker fragment with `query` (1–20 characters) and `limit` (1–50, default 10).
52
- - Returns likely-US Common Stock matches first, with an `isLikelyUS` symbol-format heuristic, total match count, and truncation disclosure. Quote and profile responses remain authoritative.
55
+ - Exact `symbol` or `displaySymbol` matches rank first, ignoring case and retaining Finnhub's order among ties. Likely-US common stocks lead the remaining results. `isLikelyUS` describes symbol format. Endpoint coverage varies by security.
56
+ - Supply `exchange: "US"` for US listings. An omitted or blank exchange searches globally. A name search within one exchange can miss an ADR that a ticker search finds.
53
57
 
54
58
  ---
55
59
 
@@ -62,30 +66,32 @@ Fully covered by the `category` enum on `finnhub_get_news`, so tool-only clients
62
66
 
63
67
  ### `finnhub_get_company` <sub>tool</sub>
64
68
 
65
- - Requires `symbol`; returns company profile, nullable headline fundamentals (P/E, EPS, 52-week range, beta, dividend yield, margins, growth, ROE), and sector peers.
69
+ - Requires `symbol` and returns the profile, nullable headline fundamentals, and peers. Set `peerGrouping` to `subIndustry` (default), `industry`, or `sector`. The response identifies the selected grouping.
66
70
  - Failed metrics or peers appear in `partial`; the profile determines `symbol_not_found` and `not_us_or_paid` errors.
67
71
 
68
72
  ---
69
73
 
70
74
  ### `finnhub_get_earnings` <sub>tool</sub>
71
75
 
72
- - `history` requires `symbol` and returns past quarters' actual/estimate EPS and surprise, newest first. `calendar` accepts `from` / `to` (default today through +14 days) and an optional `symbol`, returning release dates, EPS/revenue estimates, and report times.
73
- - `limit` (1–100, default 50) caps rows with total and truncation disclosure. History without a symbol → `missing_symbol`; international or paid-only symbol → `not_us_or_paid`.
76
+ - `history` requires a symbol and returns up to `limit` available quarters of EPS actuals, estimates, and surprises (default 50).
77
+ - `calendar` accepts an optional symbol and inclusive UTC dates (`YYYY-MM-DD`, default today through 14 days ahead). Recently reported releases can include EPS and revenue actuals alongside estimates. Missing values are null. Report times include `bmo` (before open), `dmh` (during market hours), and `amc` (after close).
78
+ - Calendar pages contain up to 100 entries (default 50). Pass `nextOffset` as `offset` with the same filters to continue. At 1,500 fetched rows, Finnhub may have omitted earlier releases. Narrow the window or filter by symbol to check.
74
79
 
75
80
  ---
76
81
 
77
82
  ### `finnhub_get_news` <sub>tool</sub>
78
83
 
79
84
  - `company` requires `symbol` and accepts a date range (default last 7 days). `market` uses `category`: `general`, `forex`, `crypto`, or `merger` (see `finnhub://news-categories`).
80
- - Returns headline, source, ISO 8601 datetime, summary, and URL, newest first. `limit` (1–100, default 15) caps articles with total and truncation disclosure; company mode without a symbol → `missing_symbol`, international or paid-only symbol → `not_us_or_paid`.
85
+ - Returns plain-text headlines and summaries, source, ISO 8601 timestamp, and URL, newest first. Pages contain up to 100 articles (default 15).
86
+ - Company mode accepts inclusive UTC dates (`YYYY-MM-DD`). Follow `nextOffset` with the same filters for more fetched articles. Finnhub can omit older articles even below 250 results. Check the observed timestamps and query earlier windows for older coverage.
81
87
 
82
88
  ---
83
89
 
84
90
  ### `finnhub_get_recommendations` <sub>tool</sub>
85
91
 
86
- - Per-month strong-buy / buy / hold / sell / strong-sell counts, newest first (typically 12–24 months of history)
87
- - `limit` (1–24, default 12 — one year); reports total months and discloses truncation
88
- - Empty result (no analyst coverage) → `no_coverage`, distinct from an invalid symbol; international or paid-only symbol → `not_us_or_paid`
92
+ - Per-month strong-buy / buy / hold / sell / strong-sell counts, newest first; history depth depends on Finnhub coverage.
93
+ - `limit` accepts a positive integer (default 12). The response reports the number of months Finnhub supplied and whether more fetched rows were available.
94
+ - Empty result → `no_coverage`; it cannot distinguish an invalid symbol from a valid symbol without coverage. International or paid-only symbol → `not_us_or_paid`.
89
95
 
90
96
  ---
91
97
 
@@ -97,6 +103,8 @@ Fully covered by the `category` enum on `finnhub_get_news`, so tool-only clients
97
103
 
98
104
  ## Features
99
105
 
106
+ The `finnhub-guide` skill helps agents combine tool results into company and earnings briefings while preserving dates, missing values, and endpoint coverage limits. MCP clients can discover it through `skills/list` or read its `skill://finnhub-guide/SKILL.md` resource.
107
+
100
108
  Built on [`@cyanheads/mcp-ts-core`](https://github.com/cyanheads/mcp-ts-core): stdio and Streamable HTTP transports, pluggable auth (`none` / `jwt` / `oauth`), swappable storage (`in-memory`, `filesystem`, `Supabase`, `Cloudflare KV/R2/D1`), structured logging with optional OpenTelemetry tracing.
101
109
 
102
110
  Finnhub-specific:
@@ -109,9 +117,10 @@ Finnhub-specific:
109
117
  Agent-friendly output:
110
118
 
111
119
  - Honest sparsity — every fundamental is nullable and absent values stay null; Finnhub's thinly-covered names are surfaced as-is, never zero-filled or fabricated
112
- - Two distinct "not available" signals — `symbol_not_found` (unknown US ticker, detected from the all-zero quote / empty profile sentinel) vs. `not_us_or_paid` (international or paid-only, HTTP 403) — so an agent can tell them apart and recover
120
+ - Two distinct "not available" signals — `symbol_not_found` (all-zero quote / empty profile sentinel) vs. `not_us_or_paid` (international or paid-only, HTTP 403). An empty profile can also reflect missing instrument coverage.
121
+ - ETFs, funds, or trusts may lack company profiles, earnings history, or analyst recommendations. Empty responses retain ticker verification guidance and suggest `finnhub_get_quote` for price data without promising quote availability.
113
122
  - Typed error contracts with recovery hints on every failure, plus the `isLikelyUS` search heuristic so an agent can prioritize likely free-tier symbols
114
- - Capped lists report their total count and disclose truncation, so an agent knows when more data exists
123
+ - Calendar and company-news pages report the fetched count and observed bounds. Each page refetches Finnhub, so new or revised records can shift between requests.
115
124
 
116
125
  ## Getting started
117
126
 
@@ -119,101 +128,27 @@ This server requires a free [Finnhub API key](https://finnhub.io/register) (Dash
119
128
 
120
129
  Each user must obtain their own API key. Use is subject to [Finnhub's Terms of Service](https://finnhub.io/terms-of-service) — the free tier is for personal use only, and redistributing or sharing access to Finnhub data with third parties requires written approval from Finnhub.
121
130
 
122
- Add the following to your MCP client configuration file.
131
+ Add it to Claude Code:
123
132
 
124
- ```json
125
- {
126
- "mcpServers": {
127
- "finnhub-mcp-server": {
128
- "type": "stdio",
129
- "command": "bunx",
130
- "args": ["@cyanheads/finnhub-mcp-server@latest"],
131
- "env": {
132
- "MCP_TRANSPORT_TYPE": "stdio",
133
- "MCP_LOG_LEVEL": "info",
134
- "FINNHUB_API_KEY": "your-api-key"
135
- }
136
- }
137
- }
138
- }
133
+ ```sh
134
+ claude mcp add finnhub-mcp-server -e FINNHUB_API_KEY=your-api-key -- npx -y @cyanheads/finnhub-mcp-server
139
135
  ```
140
136
 
141
- Or with npx (no Bun required):
137
+ For other clients, add this to your MCP configuration file:
142
138
 
143
139
  ```json
144
140
  {
145
141
  "mcpServers": {
146
142
  "finnhub-mcp-server": {
147
- "type": "stdio",
148
143
  "command": "npx",
149
- "args": ["-y", "@cyanheads/finnhub-mcp-server@latest"],
150
- "env": {
151
- "MCP_TRANSPORT_TYPE": "stdio",
152
- "MCP_LOG_LEVEL": "info",
153
- "FINNHUB_API_KEY": "your-api-key"
154
- }
144
+ "args": ["-y", "@cyanheads/finnhub-mcp-server"],
145
+ "env": { "FINNHUB_API_KEY": "your-api-key" }
155
146
  }
156
147
  }
157
148
  }
158
149
  ```
159
150
 
160
- Or with Docker:
161
-
162
- ```json
163
- {
164
- "mcpServers": {
165
- "finnhub-mcp-server": {
166
- "type": "stdio",
167
- "command": "docker",
168
- "args": [
169
- "run", "-i", "--rm",
170
- "-e", "MCP_TRANSPORT_TYPE=stdio",
171
- "-e", "FINNHUB_API_KEY=your-api-key",
172
- "ghcr.io/cyanheads/finnhub-mcp-server:latest"
173
- ]
174
- }
175
- }
176
- }
177
- ```
178
-
179
- For Streamable HTTP, set the transport and start the server:
180
-
181
- ```sh
182
- MCP_TRANSPORT_TYPE=http MCP_SESSION_MODE=stateless MCP_HTTP_PORT=3010 FINNHUB_API_KEY=... bun run start:http
183
- # Server listens at http://localhost:3010/mcp
184
- ```
185
-
186
- ### Prerequisites
187
-
188
- - [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+).
189
- - A free [Finnhub API key](https://finnhub.io/register). The free tier is US equities only, real-time, 60 req/min — international symbols (any exchange-suffixed ticker like `.TO` or `.DE`) and candle/forex endpoints are paid-tier and return a clear error.
190
-
191
- ### Installation
192
-
193
- 1. **Clone the repository:**
194
-
195
- ```sh
196
- git clone https://github.com/cyanheads/finnhub-mcp-server.git
197
- ```
198
-
199
- 2. **Navigate into the directory:**
200
-
201
- ```sh
202
- cd finnhub-mcp-server
203
- ```
204
-
205
- 3. **Install dependencies:**
206
-
207
- ```sh
208
- bun install
209
- ```
210
-
211
- 4. **Configure environment:**
212
-
213
- ```sh
214
- cp .env.example .env
215
- # edit .env and set FINNHUB_API_KEY
216
- ```
151
+ For Docker or a source build, see [Running the server](#running-the-server).
217
152
 
218
153
  ## Configuration
219
154
 
@@ -241,6 +176,16 @@ See [`.env.example`](./.env.example) for the full list of optional overrides.
241
176
 
242
177
  ### Local development
243
178
 
179
+ Requires [Bun v1.4.4](https://bun.sh/) or higher (or Node.js v24+), and a free [Finnhub API key](https://finnhub.io/register).
180
+
181
+ ```sh
182
+ git clone https://github.com/cyanheads/finnhub-mcp-server.git
183
+ cd finnhub-mcp-server
184
+ bun install
185
+ cp .env.example .env
186
+ # Set FINNHUB_API_KEY in .env.
187
+ ```
188
+
244
189
  - **Build and run:**
245
190
 
246
191
  ```sh
@@ -264,11 +209,10 @@ See [`.env.example`](./.env.example) for the full list of optional overrides.
264
209
  ### Docker
265
210
 
266
211
  ```sh
267
- docker build -t finnhub-mcp-server .
268
- docker run --rm -e MCP_TRANSPORT_TYPE=http -e FINNHUB_API_KEY=your-key -p 3010:3010 finnhub-mcp-server
212
+ docker run --rm -e FINNHUB_API_KEY=your-key -p 3010:3010 ghcr.io/cyanheads/finnhub-mcp-server:latest
269
213
  ```
270
214
 
271
- The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/finnhub-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.
215
+ The image defaults to HTTP transport, stateless session mode, and logs to `/var/log/finnhub-mcp-server`. For stdio, add `-i -e MCP_TRANSPORT_TYPE=stdio` to `docker run`. To build locally, run `docker build -t finnhub-mcp-server .`; OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.
272
216
 
273
217
  ## Project structure
274
218
 
@@ -279,6 +223,7 @@ The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `
279
223
  | `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Six tools across symbols, quotes, company, earnings, news, and recommendations. |
280
224
  | `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). News-categories reference. |
281
225
  | `src/services/finnhub` | Finnhub REST client — auth, typed endpoint methods, retry, and HTTP-status classification. |
226
+ | `skills/` | Published agent guide, also served as an MCP resource. |
282
227
  | `tests/` | Unit and integration tests mirroring `src/`. |
283
228
 
284
229
  ## Development guide
@@ -0,0 +1,35 @@
1
+ ---
2
+ summary: "Normalize ticker inputs and add Finnhub workflow guidance."
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.2.0 — 2026-10-30
8
+
9
+ ## Added
10
+
11
+ - **Workflow guidance:** Publish the finnhub-guide skill and serve it as an MCP resource. Plugin installs, npm, Docker, and the desktop bundle carry the guide.
12
+ - **Plugin metadata:** Add the Agent Plugins root manifests alongside the Claude Code and Codex overlays.
13
+
14
+ ## Changed
15
+
16
+ - **Ticker inputs** trim surrounding whitespace and uppercase symbols across quotes, company data, earnings, company news, and recommendations, preserving class-share punctuation ([#9](https://github.com/cyanheads/finnhub-mcp-server/issues/9)).
17
+ - **Coverage recovery** conditionally explains missing ETF, fund, or trust data and suggests quotes while retaining ticker verification ([#7](https://github.com/cyanheads/finnhub-mcp-server/issues/7)).
18
+ - **Recommendation limits** describe available upstream rows without promising a fixed history depth ([#6](https://github.com/cyanheads/finnhub-mcp-server/issues/6)).
19
+ - **Development tooling** syncs framework skills and verification scripts; install examples, issue reporting, and the one-day dependency age guard follow the updated templates.
20
+
21
+ ## Fixed
22
+
23
+ - **Desktop bundles** retain SDK skills runtime modules while stripping development files, dependency agent documentation, node-gyp intermediates, and build-only package files.
24
+
25
+ ## Dependencies
26
+
27
+ - `@cyanheads/mcp-ts-core` ^0.13.13 → ^0.13.18
28
+ - `pino-pretty` ^13.1.3 → ^13.2.0
29
+ - `zod` ^4.6.5 → ^4.6.7
30
+ - `@biomejs/biome` 2.5.15 → 2.6.4
31
+ - `@types/node` 26.6.4 → 26.6.6
32
+ - `ignore` ^7.0.12 → ^7.0.14
33
+ - `tsc-alias` ^1.9.7 → ^1.9.9
34
+ - `vitest` ^5.0.3 → ^5.0.5
35
+ - **Bun** 1.4.2 → 1.4.4 in package-manager metadata and Docker images.
@@ -0,0 +1,35 @@
1
+ ---
2
+ summary: "Page Finnhub earnings and company news and see reported EPS and revenue in the calendar."
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.2.1 — 2026-11-20
8
+
9
+ ## Added
10
+
11
+ - **Earnings calendar and company news** return `nextOffset` when additional fetched results are available. Earnings history and analyst recommendations accept larger limits (#17).
12
+ - **Earnings calendar** includes reported EPS and revenue where available and documents `dmh` for reports during market hours (#19).
13
+ - **Symbol search** accepts an exchange filter (#18).
14
+ - **Company peers** support sub-industry, industry, and sector grouping (#20).
15
+
16
+ ## Changed
17
+
18
+ - Synced framework tooling and updated the Finnhub tool guide.
19
+
20
+ ## Fixed
21
+
22
+ - **Earnings calendar and company news** report fetched date bounds and flag possible upstream omissions (#13).
23
+ - **Date windows** validate real, inclusive UTC dates and reject ranges whose start follows their end (#14).
24
+ - **Symbol search** ranks exact ticker matches first (#15).
25
+ - **Financial news** converts headline and summary HTML to plain text (#16).
26
+
27
+ ## Dependencies
28
+
29
+ - `@cyanheads/mcp-ts-core` ^0.13.18 → ^0.13.22
30
+ - Added `parse5` ^8.1.1 for news normalization.
31
+ - `@biomejs/biome` 2.6.4 → 2.6.8
32
+ - Added `commonmark` ^0.31.2 and `@types/commonmark` ^0.27.10 for Markdown rendering tests.
33
+ - `ignore` ^7.0.14 → ^7.0.16
34
+ - `tsc-alias` ^1.9.9 → ^1.9.10
35
+ - `vitest` ^5.0.5 → ^5.1.1
@@ -116,14 +116,21 @@ security: false
116
116
  resolves to whatever real item already owns 42, and timeline previews pull
117
117
  in that unrelated item's metadata.
118
118
 
119
+ Outside reporters: when the issue or PR came from outside the project
120
+ (`git-wrapup` step 5 says how to tell), thank its author in the same
121
+ parenthetical, profile linked by full URL for the same reason:
122
+
123
+ ([#38](https://github.com/cyanheads/mcp-ts-core/issues/38), thanks [@octocat](https://github.com/octocat)!)
124
+
119
125
  TAG ANNOTATIONS — the annotated tag body renders as the GitHub Release body
120
126
  via `gh release create --notes-from-tag`. It is a condensed digest of this
121
127
  entry, never a copy, and its format is owned by the `release-and-publish`
122
128
  skill (step 4, "Create the annotated tag"): a short subject line without the
123
129
  version, flat headline bullets — no Keep-a-Changelog section headers, no
124
- gates line — at most one deps line, issue backlinks, and the changelog link
125
- last. In release-PR mode the `git-wrapup` skill authors those bullets as the
126
- PR body's `## Changes` and the tag copies them.
130
+ gates line — at most one deps line, issue backlinks with any outside-reporter
131
+ thanks, and the changelog link last. In release-PR mode the `git-wrapup`
132
+ skill authors those bullets as the PR body's `## Changes` and the tag copies
133
+ them.
127
134
  -->
128
135
 
129
136
  ## Added
package/dist/index.js CHANGED
@@ -13,6 +13,7 @@ await createApp({
13
13
  title: 'finnhub-mcp-server',
14
14
  tools: allToolDefinitions,
15
15
  resources: allResourceDefinitions,
16
+ skills: 'skills',
16
17
  /**
17
18
  * Every tool here is a single-shot read against Finnhub — nothing calls
18
19
  * `ctx.requestInput`, so no HTTP caller needs a live session. Declaring the
@@ -20,7 +21,7 @@ await createApp({
20
21
  * explicit `MCP_SESSION_MODE` still wins.
21
22
  */
22
23
  sessionMode: 'stateless',
23
- instructions: 'Real-time US-equity market data via Finnhub. Start from a company name: finnhub_search_symbols resolves it to a US ticker, then finnhub_get_quote / _company / _earnings / _news / _recommendations work from that symbol. Free tier is US equities only — international symbols (exchange-suffixed like ".TO") return a clear not_us_or_paid error. Quotes report whether the price is live or the prior close via priceIsLive.',
24
+ instructions: 'US-equity market data and financial news via Finnhub. Resolve an unfamiliar company name with finnhub_search_symbols, then pass the returned symbol to finnhub_get_quote / _company / _earnings / _news / _recommendations. Endpoint coverage varies by instrument and plan; not_us_or_paid indicates access restrictions. Read quoteTime together with priceIsLive and market-status fields when describing price freshness.',
24
25
  setup(core) {
25
26
  initFinnhubService(core.config, core.storage);
26
27
  },
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,oBAAoB;IAC3B,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,sBAAsB;IACjC;;;;;OAKG;IACH,WAAW,EAAE,WAAW;IACxB,YAAY,EACV,kaAAka;IACpa,KAAK,CAAC,IAAI;QACR,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF,CAAC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAE3E,MAAM,SAAS,CAAC;IACd,IAAI,EAAE,oBAAoB;IAC1B,KAAK,EAAE,oBAAoB;IAC3B,KAAK,EAAE,kBAAkB;IACzB,SAAS,EAAE,sBAAsB;IACjC,MAAM,EAAE,QAAQ;IAChB;;;;;OAKG;IACH,WAAW,EAAE,WAAW;IACxB,YAAY,EACV,+ZAA+Z;IACja,KAAK,CAAC,IAAI;QACR,kBAAkB,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;CACF,CAAC,CAAC"}