{"_id":"@cyanheads/finnhub-mcp-server","_rev":"6-c35ae2d64db803b0483e0d100848f98c","name":"@cyanheads/finnhub-mcp-server","dist-tags":{"latest":"0.1.5"},"versions":{"0.1.0":{"name":"@cyanheads/finnhub-mcp-server","version":"0.1.0","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","finnhub","finance","stocks","market-data","quotes","earnings","stock-market"],"license":"Apache-2.0","_id":"@cyanheads/finnhub-mcp-server@0.1.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/finnhub-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/finnhub-mcp-server/issues"},"bin":{"finnhub-mcp-server":"dist/index.js"},"dist":{"shasum":"bdc23faaab7937cf1d0489d7bfdc10ad0cd89115","tarball":"https://registry.npmjs.org/@cyanheads/finnhub-mcp-server/-/finnhub-mcp-server-0.1.0.tgz","fileCount":61,"integrity":"sha512-e+mxFiFII9ZJ2+7uB6mKlEmzeon39VaYlbaqXziuaBh5VfoPVacER+2fp7MrN4SO2FDUt286xW0n/4DK/qSQtQ==","signatures":[{"sig":"MEYCIQDwukbrULM1xSURywiO05eOwK7LCbslsvOy+k8RV38GRQIhALBLE5XVFRPeZgIdBDxbA33ET85Cjt4vVS7FzTzNSHlS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":229603},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"bun":">=1.3.0","node":">=24.0.0"},"gitHead":"3ff385c1383252e8cf30dd5c1fc5bb2de3d9a865","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/finnhub-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/finnhub-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"repository":{"url":"git+https://github.com/cyanheads/finnhub-mcp-server.git","type":"git"},"_npmVersion":"11.12.1","description":"Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/finnhub-mcp-server_0.1.0_1781426636609_0.2145696491188045","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@cyanheads/finnhub-mcp-server","version":"0.1.1","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","finnhub","finance","stocks","market-data","quotes","earnings","stock-market"],"license":"Apache-2.0","_id":"@cyanheads/finnhub-mcp-server@0.1.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/finnhub-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/finnhub-mcp-server/issues"},"bin":{"finnhub-mcp-server":"dist/index.js"},"dist":{"shasum":"886416140152ed62605b7a2a7c2fae1e3f65efaf","tarball":"https://registry.npmjs.org/@cyanheads/finnhub-mcp-server/-/finnhub-mcp-server-0.1.1.tgz","fileCount":62,"integrity":"sha512-taXADKjJ+0R6LbwKEpLwaABO5OJ3Dy4dgsdmCcZE3/xGrVzO6XI1m5vKfGFb21t68b2KnbUPdW4VsIG8NfbUUA==","signatures":[{"sig":"MEYCIQD9z1DrBMbE5VZkVf0aG3PYL5kHqe/gaEzki9qVkDJBYQIhAInfGtGaq6uHWobAz4DgqMOThohrBFrD+dacsdx3YgmR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":230007},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"bun":">=1.3.0","node":">=24.0.0"},"gitHead":"b079b88f96d4d402e7330dda88fc06265860f5ab","mcpName":"io.github.cyanheads/finnhub-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/finnhub-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/finnhub-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"repository":{"url":"git+https://github.com/cyanheads/finnhub-mcp-server.git","type":"git"},"_npmVersion":"11.12.1","description":"Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"25.9.3","@biomejs/biome":"2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/finnhub-mcp-server_0.1.1_1781432146876_0.031238803083390776","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cyanheads/finnhub-mcp-server","version":"0.1.2","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","finnhub","finance","stocks","equities","market-data","quotes","earnings","stock-market","ai-agents","cyanheads"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/finnhub-mcp-server@0.1.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/finnhub-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/finnhub-mcp-server/issues"},"bin":{"finnhub-mcp-server":"dist/index.js"},"dist":{"shasum":"8bdc5ac4922ed8af438e5363d2d533559f68d004","tarball":"https://registry.npmjs.org/@cyanheads/finnhub-mcp-server/-/finnhub-mcp-server-0.1.2.tgz","fileCount":63,"integrity":"sha512-nkTXePiZE+4RX90YU7aQFdzurCdfkqGm2R4ywFa/iw2C+xJVIUnf2T3ka7OtHmQePJwvcN03D0gAbimYJGGchg==","signatures":[{"sig":"MEUCIQCRvWvk9WbpdIwqqc3FTu78WFLqBDtoGn8jDSmjKwVnfAIgL/0GqDHVxxB+hk796AaQqz7/SRoOd24qmveGejGMebA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":240042},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"8bdc5ac4922ed8af438e5363d2d533559f68d004","engines":{"bun":">=1.3.0","node":">=24.0.0"},"mcpName":"io.github.cyanheads/finnhub-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/finnhub-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/finnhub-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-nkTXePiZE+4RX90YU7aQFdzurCdfkqGm2R4ywFa/iw2C+xJVIUnf2T3ka7OtHmQePJwvcN03D0gAbimYJGGchg==","repository":{"url":"git+https://github.com/cyanheads/finnhub-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"26.2.0","@biomejs/biome":"2.5.9","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/finnhub-mcp-server_0.1.2_1787327775158_0.19868668342971696","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@cyanheads/finnhub-mcp-server","version":"0.1.3","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","finnhub","finance","stocks","equities","market-data","quotes","earnings","stock-market","ai-agents","cyanheads"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/finnhub-mcp-server@0.1.3","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/finnhub-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/finnhub-mcp-server/issues"},"bin":{"finnhub-mcp-server":"dist/index.js"},"dist":{"shasum":"b411ef1845a3730f958fc7e7fdb6c424faa2677f","tarball":"https://registry.npmjs.org/@cyanheads/finnhub-mcp-server/-/finnhub-mcp-server-0.1.3.tgz","fileCount":64,"integrity":"sha512-8ZT0Mdk+6j55cSsHT9K2m3a7hCIR0KlGfg8LA2ijukY/RMv57J3Zo9xNIVSk3D6vHNyfSeLAZDaLu3pNTWMPGA==","signatures":[{"sig":"MEQCIA6wVd0QQONj/i3XDnjPBkhXWDysxGp0Ztb9T7BSt+olAiBdWdWErOGxIU6qR+jCDBKd0LalW+CJHMcFt5GKpFEpdg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":242105},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"b411ef1845a3730f958fc7e7fdb6c424faa2677f","engines":{"bun":">=1.3.0","node":">=24.0.0"},"mcpName":"io.github.cyanheads/finnhub-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/finnhub-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/finnhub-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-8ZT0Mdk+6j55cSsHT9K2m3a7hCIR0KlGfg8LA2ijukY/RMv57J3Zo9xNIVSk3D6vHNyfSeLAZDaLu3pNTWMPGA==","repository":{"url":"git+https://github.com/cyanheads/finnhub-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"26.4.0","@biomejs/biome":"2.5.11","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/finnhub-mcp-server_0.1.3_1788126709485_0.5943303581436017","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@cyanheads/finnhub-mcp-server","version":"0.1.4","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","finnhub","finance","stocks","equities","market-data","quotes","earnings","stock-market","ai-agents","cyanheads"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/finnhub-mcp-server@0.1.4","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/finnhub-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/finnhub-mcp-server/issues"},"bin":{"finnhub-mcp-server":"dist/index.js"},"dist":{"shasum":"5da66b5853263060eabd64b82dfa7c06bc52bf38","tarball":"https://registry.npmjs.org/@cyanheads/finnhub-mcp-server/-/finnhub-mcp-server-0.1.4.tgz","fileCount":65,"integrity":"sha512-VZKtOCXv7Yvhtpy5Eyyl3PO8T1EoAJaQHrtv8zBYsZ/zzQYYdpnVY1FL+qFmLzT5uFnHhsVBfTJ/VQKNjKKgfA==","signatures":[{"sig":"MEYCIQDj5VpetgY9w+hWUxdlpCZ8Ffu8lJBVm63McaDcAfkZ6wIhAIm1azgTcFWWdC/JPXo8M42hCgzOLybWudWPjtE2tIQJ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":246923},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"5da66b5853263060eabd64b82dfa7c06bc52bf38","engines":{"bun":">=1.3.0","node":">=24.0.0"},"mcpName":"io.github.cyanheads/finnhub-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/finnhub-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/finnhub-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-VZKtOCXv7Yvhtpy5Eyyl3PO8T1EoAJaQHrtv8zBYsZ/zzQYYdpnVY1FL+qFmLzT5uFnHhsVBfTJ/VQKNjKKgfA==","repository":{"url":"git+https://github.com/cyanheads/finnhub-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.12.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.11","depcheck":"^1.4.7","tsc-alias":"^1.9.2","typescript":"^7.0.2","@types/node":"26.4.0","@biomejs/biome":"2.5.11","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/finnhub-mcp-server_0.1.4_1788144277906_0.1099237035788716","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"_id":"@cyanheads/finnhub-mcp-server@0.1.5","bin":{"finnhub-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/finnhub-mcp-server/issues"},"dist":{"shasum":"b98ff3e89a340d0df73a9f34deb6828ada85dafc","tarball":"https://registry.npmjs.org/@cyanheads/finnhub-mcp-server/-/finnhub-mcp-server-0.1.5.tgz","fileCount":66,"integrity":"sha512-DNd0et60hrYCqijT/gC3xEElBxJ9xw7CtL7Fx1tj3TC+Ei4Os1scsLsnr8oUbPAU1a6BuSQ3Qcl8OHVsyk/6UQ==","signatures":[{"sig":"MEUCIQDT8Gz/PIknU+u5IO5BqfOoWTy1uMTHlY0vJvVPfPYy1gIgMjvZqZSGe+bou+vuxk8oW/ykIt4OHKTZz33+vymmTBc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBQ5vt3JR0XilOLzIW0iJUvmZGzmqa+0STgvHVOqf9xrAiBL+i+ufdXkmK+16JPSW9u0L+63K0i0Q7aEk24pnMwUqQ=="}],"unpackedSize":257306},"main":"dist/index.js","name":"@cyanheads/finnhub-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand (https://caseyjhand.com)","shasum":"b98ff3e89a340d0df73a9f34deb6828ada85dafc","engines":{"bun":">=1.4.0","node":">=24.0.0"},"funding":[{"url":"https://github.com/sponsors/cyanheads","type":"github"},{"url":"https://www.buymeacoffee.com/cyanheads","type":"buy_me_a_coffee"}],"license":"Apache-2.0","mcpName":"io.github.cyanheads/finnhub-mcp-server","scripts":{"test":"vitest run","tree":"bun run scripts/tree.ts","build":"bun run scripts/build.ts","clean":"bun run scripts/clean.ts","start":"node dist/index.js","bundle":"bun run build && npx -y @anthropic-ai/mcpb pack . dist/finnhub-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/finnhub-mcp-server.mcpb","format":"biome check --write .","rebuild":"bun run scripts/clean.ts && bun run scripts/build.ts","devcheck":"bun run scripts/devcheck.ts","lint:mcp":"bun run scripts/lint-mcp.ts","audit:fix":"bun audit fix","start:http":"MCP_TRANSPORT_TYPE=http node dist/index.js","list-skills":"bun run scripts/list-skills.ts","publish-mcp":"mcp-publisher login github -token \"$(security find-generic-password -a \"$USER\" -s mcp-publisher-github-pat -w)\" && mcp-publisher publish","start:stdio":"MCP_TRANSPORT_TYPE=stdio node dist/index.js","audit:refresh":"rm -f bun.lock && bun install && bun audit","format:unsafe":"biome check --write --unsafe .","lint:packaging":"bun run scripts/lint-packaging.ts","release:github":"bun run scripts/release-github.ts","changelog:build":"bun run scripts/build-changelog.ts","changelog:check":"bun run scripts/build-changelog.ts --check"},"version":"0.1.5","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/finnhub-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","finnhub","finance","stocks","equities","market-data","quotes","earnings","stock-market","ai-agents","cyanheads"],"_integrity":"sha512-DNd0et60hrYCqijT/gC3xEElBxJ9xw7CtL7Fx1tj3TC+Ei4Os1scsLsnr8oUbPAU1a6BuSQ3Qcl8OHVsyk/6UQ==","repository":{"url":"git+https://github.com/cyanheads/finnhub-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.","directories":{},"maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.13.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.9","vitest":"^5.0.1","depcheck":"^1.4.7","tsc-alias":"^1.9.5","typescript":"^7.0.2","@types/node":"26.6.1","@biomejs/biome":"2.5.14","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/finnhub-mcp-server_0.1.5_1789939655694_0.14835559041257973"}}},"time":{"created":"2026-06-14T08:43:56.384Z","modified":"2026-09-20T21:27:35.959Z","0.1.0":"2026-06-14T08:43:56.763Z","0.1.1":"2026-06-14T10:15:47.014Z","0.1.2":"2026-08-21T15:56:15.309Z","0.1.3":"2026-08-30T21:51:49.631Z","0.1.4":"2026-08-31T02:44:38.090Z","0.1.5":"2026-09-20T21:27:35.801Z"},"bugs":{"url":"https://github.com/cyanheads/finnhub-mcp-server/issues"},"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/finnhub-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","finnhub","finance","stocks","equities","market-data","quotes","earnings","stock-market","ai-agents","cyanheads"],"repository":{"url":"git+https://github.com/cyanheads/finnhub-mcp-server.git","type":"git"},"description":"Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"
\n

@cyanheads/finnhub-mcp-server

\n

Real-time US-equity quotes, company fundamentals, earnings, analyst trends, and financial news via Finnhub. STDIO or Streamable HTTP.\n

6 Tools • 1 Resource
\n

\n
\n\n
\n\n[![Version](https://img.shields.io/badge/Version-0.1.5-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/finnhub-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.0.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/finnhub-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/finnhub-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.0-blueviolet.svg?style=flat-square)](https://bun.sh/)\n\n
\n\n
\n\n[![Install in Claude Desktop](https://img.shields.io/badge/Install_in-Claude_Desktop-D97757?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/cyanheads/finnhub-mcp-server/releases/latest/download/finnhub-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=finnhub-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvZmlubmh1Yi1tY3Atc2VydmVyIl0sImVudiI6eyJGSU5OSFVCX0FQSV9LRVkiOiJ5b3VyLWFwaS1rZXkifX0=) [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect?url=vscode:mcp/install?%7B%22name%22%3A%22finnhub-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Ffinnhub-mcp-server%22%5D%2C%22env%22%3A%7B%22FINNHUB_API_KEY%22%3A%22your-api-key%22%7D%7D)\n\n[![Framework](https://img.shields.io/badge/Built%20on-@cyanheads/mcp--ts--core-67E8F9?style=flat-square)](https://www.npmjs.com/package/@cyanheads/mcp-ts-core)\n\n
\n\n---\n\n## Overview\n\nReal-time US-equity data from Finnhub — quotes, company fundamentals, earnings, analyst recommendations, and financial news. Resolve a company name to a symbol with `finnhub_search_symbols`, then pull live pricing, valuation, or news for it from any MCP client. Runs as a stdio process or a local Streamable HTTP server.\n\n### Tools\n\n| Tool | Description |\n|:---|:---|\n| `finnhub_search_symbols` | Resolve a company name or partial ticker to stock symbols, best likely-US match first. The entry point for every other tool. |\n| `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. |\n| `finnhub_get_company` | Full company context in one call — profile, headline fundamentals (P/E, EPS, margins, growth), and sector peers. |\n| `finnhub_get_earnings` | Earnings in two modes: a symbol's past quarters with actual-vs-estimate surprises (`history`), or upcoming releases in a date window with an optional symbol filter (`calendar`). |\n| `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`). |\n| `finnhub_get_recommendations` | Analyst recommendation trends for one US symbol — strong-buy / buy / hold / sell / strong-sell counts per month, newest first. |\n\n### Resources\n\n| Resource | Description |\n|:---|:---|\n| `finnhub://news-categories` | The four valid market-news categories (`general`, `forex`, `crypto`, `merger`) with one-line descriptions. |\n\nFully covered by the `category` enum on `finnhub_get_news`, so tool-only clients lose nothing.\n\n## Capability reference\n\n### `finnhub_search_symbols` tool\n\n- Full-text match across symbols and descriptions; likely-US Common Stock matches surfaced first\n- `query` accepts 1–20 characters; use a shorter company name or ticker fragment when needed\n- Each result carries `isLikelyUS`, a symbol-format heuristic: plain tickers and `.A`/`.B` class shares are likely US, while exchange suffixes such as `.SS`, `.T`, and `.L` are not. Quote and profile responses remain authoritative\n- `limit` (1–50, default 10); reports the total match count and discloses truncation when more matched than returned\n\n---\n\n### `finnhub_get_quote` tool\n\n- Current price, absolute and percent change, session open/high/low, previous close, and an ISO 8601 quote time\n- Pairs `/quote` with `/stock/market-status` (parallel fan-out) to derive `priceIsLive` — `true` only when the US market is open; when closed, `current` is the prior close, surfaced as such\n- Exposes Finnhub's nullable `session` (`pre-market`, `regular`, or `post-market`) and returned holiday event name without inferring either value\n- Market-status failing degrades to `marketOpen: null`, `session: null`, and `holiday: null` rather than tanking the quote\n- Unknown US ticker → `symbol_not_found`; international or paid-only symbol → `not_us_or_paid`\n\n---\n\n### `finnhub_get_company` tool\n\n- Profile: name, exchange, industry, country, currency, market cap, shares outstanding, IPO date, website, logo\n- Headline fundamentals: P/E (TTM), EPS (TTM), 52-week range, beta, dividend yield, net/gross margin, revenue growth YoY, ROE — every field nullable, surfaced honestly for thinly-covered names rather than zero-filled\n- Sector peers from `/stock/peers` (includes the queried symbol)\n- Combines three endpoints under a parallel fan-out; metrics or peers failing degrade to a `partial` list, profile drives the not-found / forbidden errors\n\n---\n\n### `finnhub_get_earnings` tool\n\n- `history` (requires `symbol`): past quarters — actual vs. estimate EPS, absolute surprise, and surprise % (the market-moving signal), newest first\n- `calendar` (uses `from` / `to`, defaults to today through +14 days; optional `symbol` filter): upcoming releases across the market or for one symbol — date, EPS/revenue estimates, expected report time\n- `limit` (1–100, default 50); reports total rows and discloses truncation\n- `history` without `symbol` → `missing_symbol`; international or paid-only symbol → `not_us_or_paid`\n\n---\n\n### `finnhub_get_news` tool\n\n- `company` (requires `symbol`): recent articles over a date range (defaults to the last 7 days) — headline, source, ISO 8601 datetime, summary, URL\n- `market` (uses `category`): broad headlines by `general`, `forex`, `crypto`, or `merger` (see the `finnhub://news-categories` resource)\n- `limit` (1–100, default 15 — news lists run long); articles newest first, with total and truncation disclosure\n- `company` without `symbol` → `missing_symbol`; international or paid-only symbol → `not_us_or_paid`\n\n---\n\n### `finnhub_get_recommendations` tool\n\n- Per-month strong-buy / buy / hold / sell / strong-sell counts, newest first (typically 12–24 months of history)\n- `limit` (1–24, default 12 — one year); reports total months and discloses truncation\n- Empty result (no analyst coverage) → `no_coverage`, distinct from an invalid symbol; international or paid-only symbol → `not_us_or_paid`\n\n---\n\n### `finnhub://news-categories` resource\n\n- Returns the four valid `finnhub_get_news` market-mode categories (`general`, `forex`, `crypto`, `merger`) with one-line descriptions, as `application/json`\n- Convenience mirror — fully covered by the `category` enum's `.describe()` on `finnhub_get_news`, so tool-only clients lose nothing\n- Live data (quotes, news, earnings) is intentionally not exposed as a resource — it's time-sensitive, so freshness lives only in the tools\n\n## Features\n\nBuilt 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.\n\nFinnhub-specific:\n\n- Single rate-aware Finnhub client — token injected server-side (never a tool input), with timeout and retry calibrated to the 60 req/min free tier\n- Live market-status pairing on quotes so a closed-market price is reported as the prior close, never as live\n- Status classification at the service boundary: 403 → a clear `not_us_or_paid` domain error, 401 → loud configuration failure at first call (not \"no data\"), 429/5xx → retried\n- `finnhub_get_company` fans out profile + metrics + peers in parallel and degrades to partial results when a leg fails\n\nAgent-friendly output:\n\n- 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\n- Two distinct \"not available\" signals — `symbol_not_found` (unknown US ticker, detected from the all-zero quote / empty profile sentinel) vs. `not_us_or_paid` (international or paid-only, HTTP 403) — so an agent can tell them apart and recover\n- Typed error contracts with recovery hints on every failure, plus the `isLikelyUS` search heuristic so an agent can prioritize likely free-tier symbols\n- Capped lists report their total count and disclose truncation, so an agent knows when more data exists\n\n## Getting started\n\nThis server requires a free [Finnhub API key](https://finnhub.io/register) (Dashboard → API key). The free tier covers US equities in real time at 60 req/min.\n\nEach 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.\n\nAdd the following to your MCP client configuration file.\n\n```json\n{\n \"mcpServers\": {\n \"finnhub-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/finnhub-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\",\n \"FINNHUB_API_KEY\": \"your-api-key\"\n }\n }\n }\n}\n```\n\nOr with npx (no Bun required):\n\n```json\n{\n \"mcpServers\": {\n \"finnhub-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cyanheads/finnhub-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\",\n \"FINNHUB_API_KEY\": \"your-api-key\"\n }\n }\n }\n}\n```\n\nOr with Docker:\n\n```json\n{\n \"mcpServers\": {\n \"finnhub-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\",\n \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n \"-e\", \"FINNHUB_API_KEY=your-api-key\",\n \"ghcr.io/cyanheads/finnhub-mcp-server:latest\"\n ]\n }\n }\n}\n```\n\nFor Streamable HTTP, set the transport and start the server:\n\n```sh\nMCP_TRANSPORT_TYPE=http MCP_SESSION_MODE=stateless MCP_HTTP_PORT=3010 FINNHUB_API_KEY=... bun run start:http\n# Server listens at http://localhost:3010/mcp\n```\n\n### Prerequisites\n\n- [Bun v1.4.0](https://bun.sh/) or higher (or Node.js v24+).\n- 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.\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/finnhub-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd finnhub-mcp-server\n```\n\n3. **Install dependencies:**\n\n```sh\nbun install\n```\n\n4. **Configure environment:**\n\n```sh\ncp .env.example .env\n# edit .env and set FINNHUB_API_KEY\n```\n\n## Configuration\n\nAll configuration is validated at startup via Zod schemas in `src/config/server-config.ts`. Key environment variables:\n\n| Variable | Description | Default |\n|:---|:---|:---|\n| `FINNHUB_API_KEY` | **Required.** Free Finnhub API key from [finnhub.io/register](https://finnhub.io/register). Sent as the `token` query param; the server fails to start without it. | — |\n| `FINNHUB_BASE_URL` | Finnhub REST API base URL. Override for local testing or a proxy. | `https://finnhub.io/api/v1` |\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |\n| `MCP_HTTP_PORT` | Port for the HTTP server. | `3010` |\n| `MCP_HTTP_ENDPOINT_PATH` | HTTP endpoint path where the MCP server is mounted. | `/mcp` |\n| `MCP_SESSION_MODE` | Session handling: `auto`, `stateful`, or `stateless`. The server declares `stateless` in `src/index.ts`, so an unset variable resolves there; `.env.example` and the Docker image set it explicitly too. An explicit environment value takes precedence. | `stateless` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |\n| `MCP_LOG_LEVEL` | Log level (RFC 5424: `debug`, `info`, `notice`, `warning`, `error`). | `info` |\n| `STORAGE_PROVIDER_TYPE` | Storage backend: `in-memory`, `filesystem`, `supabase`, `cloudflare-kv/r2/d1`. | `in-memory` |\n| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry) (spans, metrics, completion logs). | `false` |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides.\n\n## Running the server\n\n### Local development\n\n- **Build and run:**\n\n ```sh\n # One-time build\n bun run rebuild\n\n # Run the built server\n bun run start:stdio\n # or\n bun run start:http\n ```\n\n- **Run checks and tests:**\n\n ```sh\n bun run devcheck # Lint, format, typecheck, security\n bun run test # Vitest test suite\n bun run lint:mcp # Validate MCP definitions against spec\n ```\n\n### Docker\n\n```sh\ndocker build -t finnhub-mcp-server .\ndocker run --rm -e MCP_TRANSPORT_TYPE=http -e FINNHUB_API_KEY=your-key -p 3010:3010 finnhub-mcp-server\n```\n\nThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/finnhub-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them.\n\n## Project structure\n\n| Directory | Purpose |\n|:---|:---|\n| `src/index.ts` | `createApp()` entry point — registers tools/resources and inits the Finnhub service. |\n| `src/config` | Server-specific environment variable parsing and validation with Zod. |\n| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Six tools across symbols, quotes, company, earnings, news, and recommendations. |\n| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). News-categories reference. |\n| `src/services/finnhub` | Finnhub REST client — auth, typed endpoint methods, retry, and HTTP-status classification. |\n| `tests/` | Unit and integration tests mirroring `src/`. |\n\n## Development guide\n\nSee [`CLAUDE.md`](./CLAUDE.md) / [`AGENTS.md`](./AGENTS.md) for development guidelines and architectural rules. The short version:\n\n- Handlers throw, framework catches — no `try/catch` in tool logic\n- Use `ctx.log` for request-scoped logging, `ctx.state` for tenant-scoped storage\n- Register new tools and resources via the barrels in `src/mcp-server/*/definitions/index.ts`\n- Wrap the Finnhub API: validate raw → normalize to domain type → return output schema; never fabricate missing fields\n\n## Contributing\n\nIssues are welcome. Run checks and tests before submitting:\n\n```sh\nbun run devcheck\nbun run test\n```\n\n## License\n\nApache-2.0 — see [LICENSE](LICENSE) for details.\n","readmeFilename":"README.md"}