@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.
- package/AGENTS.md +21 -9
- package/CLAUDE.md +21 -9
- package/Dockerfile +7 -3
- package/README.md +46 -101
- package/changelog/0.2.x/0.2.0.md +35 -0
- package/changelog/0.2.x/0.2.1.md +35 -0
- package/changelog/template.md +10 -3
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +12 -2
- package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.js +16 -8
- package/dist/mcp-server/tools/definitions/get-company.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts +25 -2
- package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-earnings.tool.js +88 -42
- package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-news.tool.d.ts +16 -0
- package/dist/mcp-server/tools/definitions/get-news.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-news.tool.js +90 -34
- package/dist/mcp-server/tools/definitions/get-news.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-quote.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-quote.tool.js +4 -2
- package/dist/mcp-server/tools/definitions/get-quote.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.js +7 -6
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +93 -42
- package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts +2 -0
- package/dist/mcp-server/tools/definitions/search-symbols.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/search-symbols.tool.js +28 -18
- package/dist/mcp-server/tools/definitions/search-symbols.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/window-page.d.ts +21 -0
- package/dist/mcp-server/tools/definitions/window-page.d.ts.map +1 -0
- package/dist/mcp-server/tools/definitions/window-page.js +39 -0
- package/dist/mcp-server/tools/definitions/window-page.js.map +1 -0
- package/dist/services/finnhub/date-window.d.ts +13 -0
- package/dist/services/finnhub/date-window.d.ts.map +1 -0
- package/dist/services/finnhub/date-window.js +32 -0
- package/dist/services/finnhub/date-window.js.map +1 -0
- package/dist/services/finnhub/finnhub-service.d.ts +4 -4
- package/dist/services/finnhub/finnhub-service.d.ts.map +1 -1
- package/dist/services/finnhub/finnhub-service.js +6 -6
- package/dist/services/finnhub/finnhub-service.js.map +1 -1
- package/dist/services/finnhub/normalize-article-text.d.ts +6 -0
- package/dist/services/finnhub/normalize-article-text.d.ts.map +1 -0
- package/dist/services/finnhub/normalize-article-text.js +97 -0
- package/dist/services/finnhub/normalize-article-text.js.map +1 -0
- package/dist/services/finnhub/types.d.ts +3 -3
- package/dist/services/finnhub/types.d.ts.map +1 -1
- package/package.json +15 -11
- package/server.json +3 -3
- 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
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.
|
|
6
|
-
**Engines:** Bun ≥1.4.
|
|
7
|
-
**MCP SDK:** `@modelcontextprotocol/server` 2.
|
|
8
|
-
**Zod:** ^4.6.
|
|
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
|
-
|
|
261
|
+
Two skill trees live at the project root, written for different readers:
|
|
262
262
|
|
|
263
|
-
|
|
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
|
-
`
|
|
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
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.
|
|
6
|
-
**Engines:** Bun ≥1.4.
|
|
7
|
-
**MCP SDK:** `@modelcontextprotocol/server` 2.
|
|
8
|
-
**Zod:** ^4.6.
|
|
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
|
-
|
|
261
|
+
Two skill trees live at the project root, written for different readers:
|
|
262
262
|
|
|
263
|
-
|
|
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
|
-
`
|
|
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.
|
|
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.
|
|
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.
|
|
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 •
|
|
4
|
+
<div>6 Tools • 2 Resources</div>
|
|
5
5
|
</p>
|
|
6
6
|
</div>
|
|
7
7
|
|
|
8
8
|
<div align="center">
|
|
9
9
|
|
|
10
|
-
[](./CHANGELOG.md) [](./LICENSE) [](https://github.com/users/cyanheads/packages/container/package/finnhub-mcp-server) [](https://modelcontextprotocol.io/) [](https://www.npmjs.com/package/@cyanheads/finnhub-mcp-server) [](https://www.typescriptlang.org/) [](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
|
|
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
|
|
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` |
|
|
35
|
-
| `finnhub_get_earnings` |
|
|
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
|
-
|
|
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
|
-
-
|
|
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
|
|
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
|
|
73
|
-
- `
|
|
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
|
|
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
|
|
87
|
-
- `limit` (
|
|
88
|
-
- Empty result
|
|
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` (
|
|
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
|
-
-
|
|
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
|
|
131
|
+
Add it to Claude Code:
|
|
123
132
|
|
|
124
|
-
```
|
|
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
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
package/changelog/template.md
CHANGED
|
@@ -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
|
|
125
|
-
last. In release-PR mode the `git-wrapup`
|
|
126
|
-
PR body's `## Changes` and the tag copies
|
|
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: '
|
|
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
|
|
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"}
|