@cyanheads/finnhub-mcp-server 0.1.6 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +17 -7
- package/CLAUDE.md +17 -7
- package/Dockerfile +7 -3
- package/README.md +34 -92
- package/changelog/0.2.x/0.2.0.md +35 -0
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.d.ts +1 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-company.tool.js +5 -3
- package/dist/mcp-server/tools/definitions/get-company.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-earnings.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-earnings.tool.js +4 -2
- package/dist/mcp-server/tools/definitions/get-earnings.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/get-news.tool.d.ts.map +1 -1
- package/dist/mcp-server/tools/definitions/get-news.tool.js +3 -1
- 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 -5
- package/dist/mcp-server/tools/definitions/get-recommendations.tool.js.map +1 -1
- package/dist/mcp-server/tools/definitions/index.d.ts +47 -47
- package/package.json +11 -10
- 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.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.
|
|
4
|
+
**Version:** 0.2.0
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.18`
|
|
6
6
|
**Engines:** Bun ≥1.4.0, Node ≥24.0.0
|
|
7
|
-
**MCP SDK:** `@modelcontextprotocol/server` 2.
|
|
8
|
-
**Zod:** ^4.6.
|
|
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 |
|
|
@@ -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/`, `SKILL.md`); 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/`, `CLAUDE.md`, `AGENTS.md`, 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
|
|
package/CLAUDE.md
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
# Developer Protocol
|
|
2
2
|
|
|
3
3
|
**Server:** finnhub-mcp-server
|
|
4
|
-
**Version:** 0.
|
|
5
|
-
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.
|
|
4
|
+
**Version:** 0.2.0
|
|
5
|
+
**Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.13.18`
|
|
6
6
|
**Engines:** Bun ≥1.4.0, Node ≥24.0.0
|
|
7
|
-
**MCP SDK:** `@modelcontextprotocol/server` 2.
|
|
8
|
-
**Zod:** ^4.6.
|
|
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 |
|
|
@@ -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/`, `SKILL.md`); 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/`, `CLAUDE.md`, `AGENTS.md`, 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
|
|
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,7 +23,9 @@
|
|
|
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
|
|
|
@@ -41,8 +43,9 @@ 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
|
|
|
@@ -83,9 +86,9 @@ Fully covered by the `category` enum on `finnhub_get_news`, so tool-only clients
|
|
|
83
86
|
|
|
84
87
|
### `finnhub_get_recommendations` <sub>tool</sub>
|
|
85
88
|
|
|
86
|
-
- Per-month strong-buy / buy / hold / sell / strong-sell counts, newest first
|
|
87
|
-
- `limit` (1–24, default 12
|
|
88
|
-
- Empty result
|
|
89
|
+
- Per-month strong-buy / buy / hold / sell / strong-sell counts, newest first; history depth depends on Finnhub coverage.
|
|
90
|
+
- `limit` (1–24, default 12) caps available rows; raising it cannot retrieve history absent from Finnhub. Reports total months and discloses truncation.
|
|
91
|
+
- 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
92
|
|
|
90
93
|
---
|
|
91
94
|
|
|
@@ -97,6 +100,8 @@ Fully covered by the `category` enum on `finnhub_get_news`, so tool-only clients
|
|
|
97
100
|
|
|
98
101
|
## Features
|
|
99
102
|
|
|
103
|
+
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.
|
|
104
|
+
|
|
100
105
|
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
106
|
|
|
102
107
|
Finnhub-specific:
|
|
@@ -109,7 +114,8 @@ Finnhub-specific:
|
|
|
109
114
|
Agent-friendly output:
|
|
110
115
|
|
|
111
116
|
- 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` (
|
|
117
|
+
- 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.
|
|
118
|
+
- 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
119
|
- Typed error contracts with recovery hints on every failure, plus the `isLikelyUS` search heuristic so an agent can prioritize likely free-tier symbols
|
|
114
120
|
- Capped lists report their total count and disclose truncation, so an agent knows when more data exists
|
|
115
121
|
|
|
@@ -119,101 +125,27 @@ This server requires a free [Finnhub API key](https://finnhub.io/register) (Dash
|
|
|
119
125
|
|
|
120
126
|
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
127
|
|
|
122
|
-
Add
|
|
128
|
+
Add it to Claude Code:
|
|
123
129
|
|
|
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
|
-
}
|
|
130
|
+
```sh
|
|
131
|
+
claude mcp add finnhub-mcp-server -e FINNHUB_API_KEY=your-api-key -- npx -y @cyanheads/finnhub-mcp-server
|
|
139
132
|
```
|
|
140
133
|
|
|
141
|
-
|
|
134
|
+
For other clients, add this to your MCP configuration file:
|
|
142
135
|
|
|
143
136
|
```json
|
|
144
137
|
{
|
|
145
138
|
"mcpServers": {
|
|
146
139
|
"finnhub-mcp-server": {
|
|
147
|
-
"type": "stdio",
|
|
148
140
|
"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
|
-
}
|
|
141
|
+
"args": ["-y", "@cyanheads/finnhub-mcp-server"],
|
|
142
|
+
"env": { "FINNHUB_API_KEY": "your-api-key" }
|
|
155
143
|
}
|
|
156
144
|
}
|
|
157
145
|
}
|
|
158
146
|
```
|
|
159
147
|
|
|
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
|
-
```
|
|
148
|
+
For Docker or a source build, see [Running the server](#running-the-server).
|
|
217
149
|
|
|
218
150
|
## Configuration
|
|
219
151
|
|
|
@@ -241,6 +173,16 @@ See [`.env.example`](./.env.example) for the full list of optional overrides.
|
|
|
241
173
|
|
|
242
174
|
### Local development
|
|
243
175
|
|
|
176
|
+
Requires [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+), and a free [Finnhub API key](https://finnhub.io/register).
|
|
177
|
+
|
|
178
|
+
```sh
|
|
179
|
+
git clone https://github.com/cyanheads/finnhub-mcp-server.git
|
|
180
|
+
cd finnhub-mcp-server
|
|
181
|
+
bun install
|
|
182
|
+
cp .env.example .env
|
|
183
|
+
# Set FINNHUB_API_KEY in .env.
|
|
184
|
+
```
|
|
185
|
+
|
|
244
186
|
- **Build and run:**
|
|
245
187
|
|
|
246
188
|
```sh
|
|
@@ -264,11 +206,10 @@ See [`.env.example`](./.env.example) for the full list of optional overrides.
|
|
|
264
206
|
### Docker
|
|
265
207
|
|
|
266
208
|
```sh
|
|
267
|
-
docker
|
|
268
|
-
docker run --rm -e MCP_TRANSPORT_TYPE=http -e FINNHUB_API_KEY=your-key -p 3010:3010 finnhub-mcp-server
|
|
209
|
+
docker run --rm -e FINNHUB_API_KEY=your-key -p 3010:3010 ghcr.io/cyanheads/finnhub-mcp-server:latest
|
|
269
210
|
```
|
|
270
211
|
|
|
271
|
-
The
|
|
212
|
+
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
213
|
|
|
273
214
|
## Project structure
|
|
274
215
|
|
|
@@ -279,6 +220,7 @@ The Dockerfile defaults to HTTP transport, stateless session mode, and logs to `
|
|
|
279
220
|
| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Six tools across symbols, quotes, company, earnings, news, and recommendations. |
|
|
280
221
|
| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). News-categories reference. |
|
|
281
222
|
| `src/services/finnhub` | Finnhub REST client — auth, typed endpoint methods, retry, and HTTP-status classification. |
|
|
223
|
+
| `skills/` | Published agent guide, also served as an MCP resource. |
|
|
282
224
|
| `tests/` | Unit and integration tests mirroring `src/`. |
|
|
283
225
|
|
|
284
226
|
## 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.
|
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"}
|
|
@@ -41,7 +41,7 @@ export declare const getCompany: import("@cyanheads/mcp-ts-core").ToolDefinition
|
|
|
41
41
|
readonly reason: "symbol_not_found";
|
|
42
42
|
readonly code: JsonRpcErrorCode.NotFound;
|
|
43
43
|
readonly when: "/stock/profile2 returned an empty object for the symbol.";
|
|
44
|
-
readonly recovery: "Verify the ticker, or
|
|
44
|
+
readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack company profiles; try finnhub_get_quote for price data.";
|
|
45
45
|
}, {
|
|
46
46
|
readonly reason: "not_us_or_paid";
|
|
47
47
|
readonly code: JsonRpcErrorCode.Forbidden;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-company.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-company.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAU3E,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"get-company.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-company.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAU3E,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cA6MrB,CAAC"}
|
|
@@ -19,11 +19,13 @@ export const getCompany = tool('finnhub_get_company', {
|
|
|
19
19
|
input: z.object({
|
|
20
20
|
symbol: z
|
|
21
21
|
.string()
|
|
22
|
+
.trim()
|
|
23
|
+
.toUpperCase()
|
|
22
24
|
.min(1)
|
|
23
|
-
.describe('US stock ticker (e.g., "AAPL"). Resolve a company name with finnhub_search_symbols first. International symbols are not on the free tier.'),
|
|
25
|
+
.describe('US stock ticker (e.g., "AAPL"), trimmed and uppercased with punctuation preserved. Resolve a company name with finnhub_search_symbols first. International symbols are not on the free tier.'),
|
|
24
26
|
}),
|
|
25
27
|
output: z.object({
|
|
26
|
-
symbol: z.string().describe('The symbol queried
|
|
28
|
+
symbol: z.string().describe('The symbol queried, trimmed and uppercased.'),
|
|
27
29
|
profile: z
|
|
28
30
|
.object({
|
|
29
31
|
name: z.string().describe('Company name.'),
|
|
@@ -71,7 +73,7 @@ export const getCompany = tool('finnhub_get_company', {
|
|
|
71
73
|
reason: 'symbol_not_found',
|
|
72
74
|
code: JsonRpcErrorCode.NotFound,
|
|
73
75
|
when: '/stock/profile2 returned an empty object for the symbol.',
|
|
74
|
-
recovery: 'Verify the ticker, or
|
|
76
|
+
recovery: 'Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack company profiles; try finnhub_get_quote for price data.',
|
|
75
77
|
},
|
|
76
78
|
{
|
|
77
79
|
reason: 'not_us_or_paid',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-company.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-company.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG1E,6EAA6E;AAC7E,SAAS,SAAS,CAAC,MAAuC,EAAE,GAAW;IACrE,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,qBAAqB,EAAE;IACpD,WAAW,EACT,scAAsc;IACxc,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,
|
|
1
|
+
{"version":3,"file":"get-company.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-company.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-earnings.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-earnings.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAQ3E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"get-earnings.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-earnings.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAQ3E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAuPtB,CAAC"}
|
|
@@ -21,8 +21,10 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
21
21
|
.describe("'history' = one symbol's past quarters with actual-vs-estimate surprises (requires `symbol`). 'calendar' = upcoming releases in a date window, optionally filtered by `symbol` (uses `from`/`to`)."),
|
|
22
22
|
symbol: z
|
|
23
23
|
.string()
|
|
24
|
+
.trim()
|
|
25
|
+
.toUpperCase()
|
|
24
26
|
.optional()
|
|
25
|
-
.describe('Required for `history`; optionally filters `calendar
|
|
27
|
+
.describe('US ticker, trimmed and uppercased with punctuation preserved. Required and nonblank for `history`; optionally filters `calendar`, where blank means market-wide. Resolve a name with finnhub_search_symbols first.'),
|
|
26
28
|
from: z
|
|
27
29
|
.string()
|
|
28
30
|
.optional()
|
|
@@ -135,7 +137,7 @@ export const getEarnings = tool('finnhub_get_earnings', {
|
|
|
135
137
|
}));
|
|
136
138
|
ctx.enrich.total(history.length);
|
|
137
139
|
if (history.length === 0) {
|
|
138
|
-
ctx.enrich.notice(`No earnings history for "${symbol}". Verify the
|
|
140
|
+
ctx.enrich.notice(`No earnings history for "${symbol}". Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack earnings history; try finnhub_get_quote for price data.`);
|
|
139
141
|
}
|
|
140
142
|
const sliced = history.slice(0, input.limit);
|
|
141
143
|
if (history.length > input.limit) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-earnings.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-earnings.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,yCAAyC;AACzC,SAAS,OAAO,CAAC,IAAU;IACzB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,sBAAsB,EAAE;IACtD,WAAW,EACT,yYAAyY;IAC3Y,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;aAC7B,QAAQ,CACP,oMAAoM,CACrM;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,CACP,
|
|
1
|
+
{"version":3,"file":"get-earnings.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-earnings.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-news.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-news.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AA8B3E,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"get-news.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-news.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AA8B3E,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwJlB,CAAC"}
|
|
@@ -32,8 +32,10 @@ export const getNews = tool('finnhub_get_news', {
|
|
|
32
32
|
.describe("'company' = recent articles for one symbol over a date range (requires `symbol`). 'market' = broad headlines by `category`."),
|
|
33
33
|
symbol: z
|
|
34
34
|
.string()
|
|
35
|
+
.trim()
|
|
36
|
+
.toUpperCase()
|
|
35
37
|
.optional()
|
|
36
|
-
.describe('Required for `company` mode. US ticker. Ignored in `market` mode.'),
|
|
38
|
+
.describe('Required and nonblank for `company` mode. US ticker, trimmed and uppercased with punctuation preserved. Ignored in `market` mode.'),
|
|
37
39
|
from: z
|
|
38
40
|
.string()
|
|
39
41
|
.optional()
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-news.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-news.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAG1E,yCAAyC;AACzC,SAAS,OAAO,CAAC,IAAU;IACzB,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,yEAAyE;AACzE,SAAS,gBAAgB,CAAC,CAAqB;IAS7C,OAAO;QACL,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC,WAAW,EAAE;QACnD,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,EAAE;QACxB,GAAG,EAAE,CAAC,CAAC,GAAG;QACV,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAG,IAAI,CAAC,kBAAkB,EAAE;IAC9C,WAAW,EACT,qWAAqW;IACvW,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,IAAI,EAAE,CAAC;aACJ,IAAI,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;aAC3B,QAAQ,CACP,6HAA6H,CAC9H;QACH,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,QAAQ,EAAE;aACV,QAAQ,
|
|
1
|
+
{"version":3,"file":"get-news.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-news.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-quote.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-quote.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"get-quote.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-quote.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsKnB,CAAC"}
|
|
@@ -14,11 +14,13 @@ export const getQuote = tool('finnhub_get_quote', {
|
|
|
14
14
|
input: z.object({
|
|
15
15
|
symbol: z
|
|
16
16
|
.string()
|
|
17
|
+
.trim()
|
|
18
|
+
.toUpperCase()
|
|
17
19
|
.min(1)
|
|
18
|
-
.describe('US stock ticker (e.g., "AAPL", "MSFT"). Resolve a company name with finnhub_search_symbols first. International symbols (with an exchange suffix like ".TO") are not on the free tier and return a clear error.'),
|
|
20
|
+
.describe('US stock ticker (e.g., "AAPL", "MSFT", "BRK.B"). Trimmed and uppercased; punctuation is preserved. Resolve a company name with finnhub_search_symbols first. International symbols (with an exchange suffix like ".TO") are not on the free tier and return a clear error.'),
|
|
19
21
|
}),
|
|
20
22
|
output: z.object({
|
|
21
|
-
symbol: z.string().describe('The symbol quoted
|
|
23
|
+
symbol: z.string().describe('The symbol quoted, trimmed and uppercased.'),
|
|
22
24
|
current: z
|
|
23
25
|
.number()
|
|
24
26
|
.describe('Current price when the market is open; the most recent close when it is not — read `priceIsLive`.'),
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-quote.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-quote.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,CAAC,mBAAmB,EAAE;IAChD,WAAW,EACT,0aAA0a;IAC5a,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,
|
|
1
|
+
{"version":3,"file":"get-quote.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-quote.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -23,7 +23,7 @@ export declare const getRecommendations: import("@cyanheads/mcp-ts-core").ToolDe
|
|
|
23
23
|
readonly reason: "no_coverage";
|
|
24
24
|
readonly code: JsonRpcErrorCode.NotFound;
|
|
25
25
|
readonly when: "Endpoint returned an empty array — no analyst coverage for the symbol.";
|
|
26
|
-
readonly recovery: "Verify the
|
|
26
|
+
readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.";
|
|
27
27
|
}, {
|
|
28
28
|
readonly reason: "not_us_or_paid";
|
|
29
29
|
readonly code: JsonRpcErrorCode.Forbidden;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-recommendations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"get-recommendations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAY,MAAM,+BAA+B,CAAC;AAG3E,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwH7B,CAAC"}
|
|
@@ -13,18 +13,20 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
|
|
|
13
13
|
input: z.object({
|
|
14
14
|
symbol: z
|
|
15
15
|
.string()
|
|
16
|
+
.trim()
|
|
17
|
+
.toUpperCase()
|
|
16
18
|
.min(1)
|
|
17
|
-
.describe('US stock ticker (e.g., "AAPL"). Resolve a name with finnhub_search_symbols first.'),
|
|
19
|
+
.describe('US stock ticker (e.g., "AAPL"), trimmed and uppercased with punctuation preserved. Resolve a name with finnhub_search_symbols first.'),
|
|
18
20
|
limit: z
|
|
19
21
|
.number()
|
|
20
22
|
.int()
|
|
21
23
|
.min(1)
|
|
22
24
|
.max(24)
|
|
23
25
|
.default(12)
|
|
24
|
-
.describe('
|
|
26
|
+
.describe('Maximum months to return from available upstream history, newest first (1–24, default 12). Increasing the limit returns more available rows, not history absent from Finnhub.'),
|
|
25
27
|
}),
|
|
26
28
|
output: z.object({
|
|
27
|
-
symbol: z.string().describe('The symbol queried
|
|
29
|
+
symbol: z.string().describe('The symbol queried, trimmed and uppercased.'),
|
|
28
30
|
trends: z
|
|
29
31
|
.array(z
|
|
30
32
|
.object({
|
|
@@ -40,7 +42,7 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
|
|
|
40
42
|
.describe('Number of analysts with a Strong Sell rating this month.'),
|
|
41
43
|
})
|
|
42
44
|
.describe('One month of analyst recommendation counts.'))
|
|
43
|
-
.describe('Recommendation counts per month, newest first.
|
|
45
|
+
.describe('Recommendation counts per month, newest first. History depth depends on Finnhub coverage.'),
|
|
44
46
|
}),
|
|
45
47
|
enrichment: {
|
|
46
48
|
totalCount: z.number().describe('Total months available before the limit.'),
|
|
@@ -53,7 +55,7 @@ export const getRecommendations = tool('finnhub_get_recommendations', {
|
|
|
53
55
|
reason: 'no_coverage',
|
|
54
56
|
code: JsonRpcErrorCode.NotFound,
|
|
55
57
|
when: 'Endpoint returned an empty array — no analyst coverage for the symbol.',
|
|
56
|
-
recovery: 'Verify the
|
|
58
|
+
recovery: 'Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.',
|
|
57
59
|
},
|
|
58
60
|
{
|
|
59
61
|
reason: 'not_us_or_paid',
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"get-recommendations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,6BAA6B,EAAE;IACpE,WAAW,EACT,mRAAmR;IACrR,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;IACxD,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC;aACN,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CACP,
|
|
1
|
+
{"version":3,"file":"get-recommendations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/get-recommendations.tool.ts"],"names":[],"mappings":"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"}
|
|
@@ -4,51 +4,6 @@
|
|
|
4
4
|
* @module mcp-server/tools/definitions/index
|
|
5
5
|
*/
|
|
6
6
|
export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
7
|
-
mode: import("zod").ZodEnum<{
|
|
8
|
-
company: "company";
|
|
9
|
-
market: "market";
|
|
10
|
-
}>;
|
|
11
|
-
symbol: import("zod").ZodOptional<import("zod").ZodString>;
|
|
12
|
-
from: import("zod").ZodOptional<import("zod").ZodString>;
|
|
13
|
-
to: import("zod").ZodOptional<import("zod").ZodString>;
|
|
14
|
-
category: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
15
|
-
crypto: "crypto";
|
|
16
|
-
forex: "forex";
|
|
17
|
-
general: "general";
|
|
18
|
-
merger: "merger";
|
|
19
|
-
}>>;
|
|
20
|
-
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
21
|
-
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
22
|
-
mode: import("zod").ZodEnum<{
|
|
23
|
-
company: "company";
|
|
24
|
-
market: "market";
|
|
25
|
-
}>;
|
|
26
|
-
articles: import("zod").ZodArray<import("zod").ZodObject<{
|
|
27
|
-
headline: import("zod").ZodString;
|
|
28
|
-
source: import("zod").ZodString;
|
|
29
|
-
datetime: import("zod").ZodString;
|
|
30
|
-
summary: import("zod").ZodString;
|
|
31
|
-
url: import("zod").ZodString;
|
|
32
|
-
category: import("zod").ZodOptional<import("zod").ZodString>;
|
|
33
|
-
related: import("zod").ZodOptional<import("zod").ZodString>;
|
|
34
|
-
}, import("zod/v4/core").$strip>>;
|
|
35
|
-
}, import("zod/v4/core").$strip>, readonly [{
|
|
36
|
-
readonly reason: "missing_symbol";
|
|
37
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
38
|
-
readonly when: "mode 'company' was requested without a symbol.";
|
|
39
|
-
readonly recovery: "Provide a `symbol` for company mode, or switch to mode: market with a category.";
|
|
40
|
-
}, {
|
|
41
|
-
readonly reason: "not_us_or_paid";
|
|
42
|
-
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
43
|
-
readonly when: "Upstream HTTP 403 on the symbol.";
|
|
44
|
-
readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
|
|
45
|
-
}], {
|
|
46
|
-
readonly totalCount: import("zod").ZodNumber;
|
|
47
|
-
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
48
|
-
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
49
|
-
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
50
|
-
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
51
|
-
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
52
7
|
query: import("zod").ZodString;
|
|
53
8
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
54
9
|
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
@@ -129,7 +84,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
129
84
|
readonly reason: "symbol_not_found";
|
|
130
85
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
131
86
|
readonly when: "/stock/profile2 returned an empty object for the symbol.";
|
|
132
|
-
readonly recovery: "Verify the ticker, or
|
|
87
|
+
readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack company profiles; try finnhub_get_quote for price data.";
|
|
133
88
|
}, {
|
|
134
89
|
readonly reason: "not_us_or_paid";
|
|
135
90
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
@@ -183,6 +138,51 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
183
138
|
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
184
139
|
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
185
140
|
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
141
|
+
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
142
|
+
mode: import("zod").ZodEnum<{
|
|
143
|
+
company: "company";
|
|
144
|
+
market: "market";
|
|
145
|
+
}>;
|
|
146
|
+
symbol: import("zod").ZodOptional<import("zod").ZodString>;
|
|
147
|
+
from: import("zod").ZodOptional<import("zod").ZodString>;
|
|
148
|
+
to: import("zod").ZodOptional<import("zod").ZodString>;
|
|
149
|
+
category: import("zod").ZodDefault<import("zod").ZodEnum<{
|
|
150
|
+
crypto: "crypto";
|
|
151
|
+
forex: "forex";
|
|
152
|
+
general: "general";
|
|
153
|
+
merger: "merger";
|
|
154
|
+
}>>;
|
|
155
|
+
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
156
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
157
|
+
mode: import("zod").ZodEnum<{
|
|
158
|
+
company: "company";
|
|
159
|
+
market: "market";
|
|
160
|
+
}>;
|
|
161
|
+
articles: import("zod").ZodArray<import("zod").ZodObject<{
|
|
162
|
+
headline: import("zod").ZodString;
|
|
163
|
+
source: import("zod").ZodString;
|
|
164
|
+
datetime: import("zod").ZodString;
|
|
165
|
+
summary: import("zod").ZodString;
|
|
166
|
+
url: import("zod").ZodString;
|
|
167
|
+
category: import("zod").ZodOptional<import("zod").ZodString>;
|
|
168
|
+
related: import("zod").ZodOptional<import("zod").ZodString>;
|
|
169
|
+
}, import("zod/v4/core").$strip>>;
|
|
170
|
+
}, import("zod/v4/core").$strip>, readonly [{
|
|
171
|
+
readonly reason: "missing_symbol";
|
|
172
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
|
|
173
|
+
readonly when: "mode 'company' was requested without a symbol.";
|
|
174
|
+
readonly recovery: "Provide a `symbol` for company mode, or switch to mode: market with a category.";
|
|
175
|
+
}, {
|
|
176
|
+
readonly reason: "not_us_or_paid";
|
|
177
|
+
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
|
178
|
+
readonly when: "Upstream HTTP 403 on the symbol.";
|
|
179
|
+
readonly recovery: "Free tier is US equities only; use a US symbol or a paid plan.";
|
|
180
|
+
}], {
|
|
181
|
+
readonly totalCount: import("zod").ZodNumber;
|
|
182
|
+
readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
|
|
183
|
+
readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
184
|
+
readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
|
|
185
|
+
readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
|
|
186
186
|
}> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
|
|
187
187
|
symbol: import("zod").ZodString;
|
|
188
188
|
limit: import("zod").ZodDefault<import("zod").ZodNumber>;
|
|
@@ -200,7 +200,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
|
|
|
200
200
|
readonly reason: "no_coverage";
|
|
201
201
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.NotFound;
|
|
202
202
|
readonly when: "Endpoint returned an empty array — no analyst coverage for the symbol.";
|
|
203
|
-
readonly recovery: "Verify the
|
|
203
|
+
readonly recovery: "Verify the ticker with finnhub_search_symbols. ETFs, funds, or trusts may lack analyst coverage, as may thinly-traded or newly-listed stocks; try finnhub_get_quote for price data.";
|
|
204
204
|
}, {
|
|
205
205
|
readonly reason: "not_us_or_paid";
|
|
206
206
|
readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Forbidden;
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@cyanheads/finnhub-mcp-server",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"mcpName": "io.github.cyanheads/finnhub-mcp-server",
|
|
5
5
|
"description": "Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.",
|
|
6
6
|
"type": "module",
|
|
@@ -11,6 +11,7 @@
|
|
|
11
11
|
},
|
|
12
12
|
"files": [
|
|
13
13
|
"changelog/",
|
|
14
|
+
"skills/",
|
|
14
15
|
"dist/",
|
|
15
16
|
"!dist/*.mcpb",
|
|
16
17
|
"README.md",
|
|
@@ -71,7 +72,7 @@
|
|
|
71
72
|
"url": "https://github.com/cyanheads/finnhub-mcp-server/issues"
|
|
72
73
|
},
|
|
73
74
|
"license": "Apache-2.0",
|
|
74
|
-
"packageManager": "bun@1.4.
|
|
75
|
+
"packageManager": "bun@1.4.4",
|
|
75
76
|
"author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
|
|
76
77
|
"engines": {
|
|
77
78
|
"bun": ">=1.4.0",
|
|
@@ -91,18 +92,18 @@
|
|
|
91
92
|
"access": "public"
|
|
92
93
|
},
|
|
93
94
|
"dependencies": {
|
|
94
|
-
"@cyanheads/mcp-ts-core": "^0.13.
|
|
95
|
-
"pino-pretty": "^13.
|
|
96
|
-
"zod": "^4.6.
|
|
95
|
+
"@cyanheads/mcp-ts-core": "^0.13.18",
|
|
96
|
+
"pino-pretty": "^13.2.0",
|
|
97
|
+
"zod": "^4.6.7"
|
|
97
98
|
},
|
|
98
99
|
"devDependencies": {
|
|
99
|
-
"@biomejs/biome": "2.
|
|
100
|
+
"@biomejs/biome": "2.6.4",
|
|
100
101
|
"@socketsecurity/bun-security-scanner": "^1.1.3",
|
|
101
|
-
"@types/node": "26.6.
|
|
102
|
+
"@types/node": "26.6.6",
|
|
102
103
|
"depcheck": "^1.4.7",
|
|
103
|
-
"ignore": "^7.0.
|
|
104
|
-
"tsc-alias": "^1.9.
|
|
104
|
+
"ignore": "^7.0.14",
|
|
105
|
+
"tsc-alias": "^1.9.9",
|
|
105
106
|
"typescript": "^7.0.2",
|
|
106
|
-
"vitest": "^5.0.
|
|
107
|
+
"vitest": "^5.0.5"
|
|
107
108
|
}
|
|
108
109
|
}
|
package/server.json
CHANGED
|
@@ -6,14 +6,14 @@
|
|
|
6
6
|
"url": "https://github.com/cyanheads/finnhub-mcp-server",
|
|
7
7
|
"source": "github"
|
|
8
8
|
},
|
|
9
|
-
"version": "0.
|
|
9
|
+
"version": "0.2.0",
|
|
10
10
|
"packages": [
|
|
11
11
|
{
|
|
12
12
|
"registryType": "npm",
|
|
13
13
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
14
14
|
"identifier": "@cyanheads/finnhub-mcp-server",
|
|
15
15
|
"runtimeHint": "npx",
|
|
16
|
-
"version": "0.
|
|
16
|
+
"version": "0.2.0",
|
|
17
17
|
"environmentVariables": [
|
|
18
18
|
{
|
|
19
19
|
"name": "FINNHUB_API_KEY",
|
|
@@ -45,7 +45,7 @@
|
|
|
45
45
|
"registryBaseUrl": "https://registry.npmjs.org",
|
|
46
46
|
"identifier": "@cyanheads/finnhub-mcp-server",
|
|
47
47
|
"runtimeHint": "npx",
|
|
48
|
-
"version": "0.
|
|
48
|
+
"version": "0.2.0",
|
|
49
49
|
"environmentVariables": [
|
|
50
50
|
{
|
|
51
51
|
"name": "MCP_TRANSPORT_TYPE",
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: finnhub-guide
|
|
3
|
+
description: Build company and earnings briefings with finnhub_* tools, preserving security identity, quote freshness, and endpoint coverage. Use when combining prices, fundamentals, earnings, news, or analyst recommendations, or investigating missing data across these tools.
|
|
4
|
+
license: Apache-2.0
|
|
5
|
+
metadata:
|
|
6
|
+
author: "cyanheads"
|
|
7
|
+
version: "1.0"
|
|
8
|
+
---
|
|
9
|
+
|
|
10
|
+
## Scope
|
|
11
|
+
|
|
12
|
+
Use Finnhub for current equity context and financial news. This surface does not provide historical price candles or FX rates; forex and crypto news categories do not imply pricing tools.
|
|
13
|
+
|
|
14
|
+
## Identifiers
|
|
15
|
+
|
|
16
|
+
For an unfamiliar company or ambiguous ticker, select the intended security from `finnhub_search_symbols` using its name and security type, then carry the returned `symbol` through the briefing. Do not substitute its display label or rewrite class-share punctuation. `isLikelyUS` is a symbol-format heuristic; a successful search does not establish access to every endpoint.
|
|
17
|
+
|
|
18
|
+
## Gates
|
|
19
|
+
|
|
20
|
+
- Before concluding that data is absent, establish the intended security and name the endpoint and window checked. An empty company-news window, empty earnings calendar, and missing analyst recommendations do not establish that the security is invalid or that no information exists elsewhere.
|
|
21
|
+
- Before interpreting missing fundamentals or peers, inspect `partial`. A failed component is unavailable; a null metric is not zero. A quote succeeding does not establish company-profile or analyst coverage for that security, including a fund or trust.
|
|
22
|
+
- Before describing a price as current, retain its quote timestamp and market-status context. A false `priceIsLive` alone does not establish a prior-close timestamp; unavailable market status means freshness is unknown. Preserve returned session and holiday information.
|
|
23
|
+
- Before claiming a list is complete, inspect truncation and totals. Increasing a limit can expose more of the fetched response, not establish exhaustive historical coverage. Do not promise a fixed depth of analyst history.
|
|
24
|
+
|
|
25
|
+
## Workflows
|
|
26
|
+
|
|
27
|
+
**Company or earnings briefing.** Resolve the security, then use `finnhub_get_quote` and `finnhub_get_company` for price and business context. For a company's next release, use its symbol with `finnhub_get_earnings` calendar mode; use history separately for reported EPS and surprises. Add `finnhub_get_news` company news for the relevant event window and `finnhub_get_recommendations` when analyst context is needed. Keep quote timestamps, fiscal periods, expected release dates, article publication times, and recommendation periods attached to their respective claims.
|
|
28
|
+
|
|
29
|
+
**Missing data.** Recheck identity before changing the question. Distinguish access denial, an unavailable component, and an empty endpoint result. Widen an empty news or calendar window when the task calls for it; use earnings history to investigate past results. Report the narrow outcome, such as “Finnhub returned no calendar entries for this company in this window,” rather than inferring no scheduled earnings or no company coverage.
|
|
30
|
+
|
|
31
|
+
**Peer comparison.** Start from the company response's peer symbols and exclude the queried security itself. Fetch the chosen peers' company context before comparing fundamentals; preserve missing values and failed components in the comparison.
|