{"_id":"@cyanheads/federal-reserve-mcp-server","_rev":"6-8852507720a384799984ff615b0717e2","name":"@cyanheads/federal-reserve-mcp-server","dist-tags":{"latest":"0.2.5"},"versions":{"0.2.0":{"name":"@cyanheads/federal-reserve-mcp-server","version":"0.2.0","keywords":["federal-reserve","fedreserve","fred","fred-api","federal-reserve-economic-data","economic-data","economics","financial-data","macroeconomics","time-series","stlouisfed","mcp","mcp-server","model-context-protocol","typescript","bun","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/federal-reserve-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/federal-reserve-mcp-server@0.2.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/federal-reserve-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/federal-reserve-mcp-server/issues"},"bin":{"federal-reserve-mcp-server":"dist/index.js"},"dist":{"shasum":"60c614885785655f99d2a4970a91d7305ab92581","tarball":"https://registry.npmjs.org/@cyanheads/federal-reserve-mcp-server/-/federal-reserve-mcp-server-0.2.0.tgz","fileCount":76,"integrity":"sha512-T0aNXrtmdXtjHLFXTsPvWcyu+4nkUfS+Ow3U7MQehhDwGmBjxG1PN3i1mjA5DBdtpxYoJ2fNSbe8lDjWfLrwtg==","signatures":[{"sig":"MEQCIG7WCfwtOYbIY7/3s0Y43boKYgFjRF8fQYZaaCX1cE7WAiBBE/aH/t4HiCvkfwDAC9roRm+72SexzTXmkXiC8q4YpQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":273399},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"60c614885785655f99d2a4970a91d7305ab92581","engines":{"bun":">=1.3.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"}],"mcpName":"io.github.cyanheads/federal-reserve-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/federal-reserve-mcp-server.mcpb","format":"biome check --write --unsafe .","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","lint:packaging":"bun run scripts/lint-packaging.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-T0aNXrtmdXtjHLFXTsPvWcyu+4nkUfS+Ow3U7MQehhDwGmBjxG1PN3i1mjA5DBdtpxYoJ2fNSbe8lDjWfLrwtg==","repository":{"url":"git+https://github.com/cyanheads/federal-reserve-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.9.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.7","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"^25.9.1","@biomejs/biome":"^2.4.15"},"_npmOperationalInternal":{"tmp":"tmp/federal-reserve-mcp-server_0.2.0_1779663713076_0.5438815573458053","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@cyanheads/federal-reserve-mcp-server","version":"0.2.1","keywords":["federal-reserve","fedreserve","fred","fred-api","federal-reserve-economic-data","economic-data","economics","financial-data","macroeconomics","time-series","stlouisfed","mcp","mcp-server","model-context-protocol","typescript","bun","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/federal-reserve-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/federal-reserve-mcp-server@0.2.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/federal-reserve-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/federal-reserve-mcp-server/issues"},"bin":{"federal-reserve-mcp-server":"dist/index.js"},"dist":{"shasum":"357e1f74a32508f1b4d93832d862ae6978ab308e","tarball":"https://registry.npmjs.org/@cyanheads/federal-reserve-mcp-server/-/federal-reserve-mcp-server-0.2.1.tgz","fileCount":73,"integrity":"sha512-76vzylz63TsX3vM8bgoR0lbdfuEtYvGUJz9ziVT4T/vy4Ogivp95rmSD37FwWCoE5qY9qOqoNZsZ/yFuTh2OOQ==","signatures":[{"sig":"MEYCIQCZJFlgnJT7Kq/FXrYx/1g9u2CfI+kPR+QV2tD3hoAg2AIhAKBhiUISDxOfqvTRJBfKHVj/BS0NsD5mVlIgQXHgcJJQ","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":276488},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"357e1f74a32508f1b4d93832d862ae6978ab308e","engines":{"bun":">=1.3.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"}],"mcpName":"io.github.cyanheads/federal-reserve-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/federal-reserve-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/federal-reserve-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","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-76vzylz63TsX3vM8bgoR0lbdfuEtYvGUJz9ziVT4T/vy4Ogivp95rmSD37FwWCoE5qY9qOqoNZsZ/yFuTh2OOQ==","repository":{"url":"git+https://github.com/cyanheads/federal-reserve-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.6"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.11","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/federal-reserve-mcp-server_0.2.1_1781326611031_0.46957568210860856","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@cyanheads/federal-reserve-mcp-server","version":"0.2.2","keywords":["federal-reserve","fedreserve","fred","fred-api","federal-reserve-economic-data","economic-data","economics","financial-data","macroeconomics","time-series","stlouisfed","mcp","mcp-server","model-context-protocol","typescript","bun","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/federal-reserve-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/federal-reserve-mcp-server@0.2.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/federal-reserve-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/federal-reserve-mcp-server/issues"},"bin":{"federal-reserve-mcp-server":"dist/index.js"},"dist":{"shasum":"e5531d818bd478798a754303f546f02ce206e0b4","tarball":"https://registry.npmjs.org/@cyanheads/federal-reserve-mcp-server/-/federal-reserve-mcp-server-0.2.2.tgz","fileCount":74,"integrity":"sha512-9v5vdF6fUjmXNOIotjnex7CEF1co43koVA2zTI1NukMHy5X4yLsWd1thCSibahvgADpNHR96IAgd5LZ54/w4YA==","signatures":[{"sig":"MEQCICNm5wfBX1V61aCG/D9RKDFSL/mNVg89hQtdUuO3V7XPAiARxrxV8KZxf/bnLwTkHau7hbr2QZdGp+43EJZzCiN6zA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":278202},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"e5531d818bd478798a754303f546f02ce206e0b4","engines":{"bun":">=1.3.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"}],"mcpName":"io.github.cyanheads/federal-reserve-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/federal-reserve-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/federal-reserve-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","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-9v5vdF6fUjmXNOIotjnex7CEF1co43koVA2zTI1NukMHy5X4yLsWd1thCSibahvgADpNHR96IAgd5LZ54/w4YA==","repository":{"url":"git+https://github.com/cyanheads/federal-reserve-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.9"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.11","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.9","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"^26.0.0","@biomejs/biome":"^2.5.0"},"_npmOperationalInternal":{"tmp":"tmp/federal-reserve-mcp-server_0.2.2_1781982339107_0.3866331371269953","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@cyanheads/federal-reserve-mcp-server","version":"0.2.3","keywords":["federal-reserve","fedreserve","fred","fred-api","federal-reserve-economic-data","economic-data","economics","financial-data","macroeconomics","time-series","stlouisfed","mcp","mcp-server","model-context-protocol","stdio","streamable-http","typescript","bun","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/federal-reserve-mcp-server@0.2.3","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/federal-reserve-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/federal-reserve-mcp-server/issues"},"bin":{"federal-reserve-mcp-server":"dist/index.js"},"dist":{"shasum":"018c70b8bc9af8b18113fa29fac6d578ab8f3656","tarball":"https://registry.npmjs.org/@cyanheads/federal-reserve-mcp-server/-/federal-reserve-mcp-server-0.2.3.tgz","fileCount":75,"integrity":"sha512-ECGn8JUr6VDvfCF9/BLcwKnNSBDljIx47STYgbfdUVYXKZas7xR34OK0GUhlQcgDvfFNIPfAAZnmd8QmYMPJPg==","signatures":[{"sig":"MEUCIQCdlTmahneW1FdKzPqEbSUWx1T5nRgT6vmzs29OKCKRYQIgGKxz93O913aKLC/yZcnIzuex/M16JEtkDT94SA2+LP0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIBdHkuKPfqa7kFcgG2oktYCIncg8qtXlRIhlmwy6XhCfAiEAq8paS6seEd9vJqY89Mv6Oc5bVTRRD0nBQuruhPEVqVA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":291533},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"018c70b8bc9af8b18113fa29fac6d578ab8f3656","engines":{"bun":">=1.3.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"}],"mcpName":"io.github.cyanheads/federal-reserve-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/federal-reserve-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/federal-reserve-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 .","test:coverage":"vitest run --coverage","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-ECGn8JUr6VDvfCF9/BLcwKnNSBDljIx47STYgbfdUVYXKZas7xR34OK0GUhlQcgDvfFNIPfAAZnmd8QmYMPJPg==","repository":{"url":"git+https://github.com/cyanheads/federal-reserve-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP. 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","@vitest/coverage-istanbul":"^4.1.10","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/federal-reserve-mcp-server_0.2.3_1787329802085_0.7005102133587007","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@cyanheads/federal-reserve-mcp-server","version":"0.2.4","keywords":["federal-reserve","fedreserve","fred","fred-api","federal-reserve-economic-data","economic-data","economics","financial-data","macroeconomics","time-series","stlouisfed","mcp","mcp-server","model-context-protocol","stdio","streamable-http","typescript","bun","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/federal-reserve-mcp-server@0.2.4","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/federal-reserve-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/federal-reserve-mcp-server/issues"},"bin":{"federal-reserve-mcp-server":"dist/index.js"},"dist":{"shasum":"3daccb3e952f6785b8cdb8c9baf27c617911b422","tarball":"https://registry.npmjs.org/@cyanheads/federal-reserve-mcp-server/-/federal-reserve-mcp-server-0.2.4.tgz","fileCount":76,"integrity":"sha512-MGYAOV/36kohK00l0oKUpBfHMS0eqk/j0+lG+jAPWj0BvPode705XzMpMQk6hmXE1qcKDE/m13sa6HdjIPYhpQ==","signatures":[{"sig":"MEYCIQDgxOTls9TxAGe1uaupKEAshN2YYDuX1Qlha/9BTFRVFgIhAJGeGwFhq375W2BZklAIz7aLjRDmK54PF8Siv20PLhD+","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIF8I/wj0o5vqZ7yMvJ0yJfxegCDz/0LBILAn8Ccx/J4nAiAzbjNt3snFuuVUvzKwtYf1TWBlxAAQaglsqnoXIaa/EQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":311398},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"3daccb3e952f6785b8cdb8c9baf27c617911b422","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"}],"mcpName":"io.github.cyanheads/federal-reserve-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/federal-reserve-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/federal-reserve-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 .","test:coverage":"vitest run --coverage","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-MGYAOV/36kohK00l0oKUpBfHMS0eqk/j0+lG+jAPWj0BvPode705XzMpMQk6hmXE1qcKDE/m13sa6HdjIPYhpQ==","repository":{"url":"git+https://github.com/cyanheads/federal-reserve-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP. STDIO or Streamable HTTP.","directories":{},"_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","@vitest/coverage-istanbul":"^5.0.1","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/federal-reserve-mcp-server_0.2.4_1789938490366_0.5253070229645422","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"_id":"@cyanheads/federal-reserve-mcp-server@0.2.5","bin":{"federal-reserve-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/federal-reserve-mcp-server/issues"},"dist":{"shasum":"7c28aeec60b05cad07f3d597001084f4ab367f17","tarball":"https://registry.npmjs.org/@cyanheads/federal-reserve-mcp-server/-/federal-reserve-mcp-server-0.2.5.tgz","fileCount":77,"integrity":"sha512-mvwkHHzw7zzmtBlXpJaOTIzNBUF2ASqLn0qwvtKFgE6jytn/kcwoD35u7ioDscHYt4P5ClKIJTgl75hKqNpZTQ==","signatures":[{"sig":"MEQCIBmUHcEQRLFmnrb4R4Rdxy8v+sjw1wza2fWSUnRwcF/9AiA9awpKch+9fl7GbgBK2PdDBOyAQnY01O88HkW1xodDyw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICt2gxgTcza3LN0EmatBJd6kO4RfnJgqEW8LCYnOFtpXAiAU60qnaRC7WcyYWaisxXNuq6CduRKtfXShfoscovbWRg=="}],"unpackedSize":315192},"main":"dist/index.js","name":"@cyanheads/federal-reserve-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand (https://caseyjhand.com)","shasum":"7c28aeec60b05cad07f3d597001084f4ab367f17","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/federal-reserve-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/federal-reserve-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/federal-reserve-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 .","test:coverage":"vitest run --coverage","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.2.5","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/federal-reserve-mcp-server#readme","keywords":["federal-reserve","fedreserve","fred","fred-api","federal-reserve-economic-data","economic-data","economics","financial-data","macroeconomics","time-series","stlouisfed","mcp","mcp-server","model-context-protocol","stdio","streamable-http","typescript","bun","ai-agent"],"_integrity":"sha512-mvwkHHzw7zzmtBlXpJaOTIzNBUF2ASqLn0qwvtKFgE6jytn/kcwoD35u7ioDscHYt4P5ClKIJTgl75hKqNpZTQ==","repository":{"url":"git+https://github.com/cyanheads/federal-reserve-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP. 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","@duckdb/node-api":"^1.5.6-r.1","@cyanheads/mcp-ts-core":"^0.13.11"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.2","devDependencies":{"ignore":"^7.0.11","vitest":"^5.0.3","depcheck":"^1.4.7","tsc-alias":"^1.9.7","typescript":"^7.0.2","@types/node":"^26.6.3","@biomejs/biome":"^2.5.15","@vitest/coverage-istanbul":"^5.0.3","@socketsecurity/bun-security-scanner":"^1.1.3"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/federal-reserve-mcp-server_0.2.5_1791095278255_0.8692993698930875"}}},"time":{"created":"2026-05-24T23:01:52.843Z","modified":"2026-10-04T06:27:58.508Z","0.2.0":"2026-05-24T23:01:53.228Z","0.2.1":"2026-06-13T04:56:51.176Z","0.2.2":"2026-06-20T19:05:39.240Z","0.2.3":"2026-08-21T16:30:02.203Z","0.2.4":"2026-09-20T21:08:10.456Z","0.2.5":"2026-10-04T06:27:58.353Z"},"bugs":{"url":"https://github.com/cyanheads/federal-reserve-mcp-server/issues"},"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/federal-reserve-mcp-server#readme","keywords":["federal-reserve","fedreserve","fred","fred-api","federal-reserve-economic-data","economic-data","economics","financial-data","macroeconomics","time-series","stlouisfed","mcp","mcp-server","model-context-protocol","stdio","streamable-http","typescript","bun","ai-agent"],"repository":{"url":"git+https://github.com/cyanheads/federal-reserve-mcp-server.git","type":"git"},"description":"Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP. STDIO or Streamable HTTP.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"
\n

@cyanheads/federal-reserve-mcp-server

\n

Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP. STDIO or Streamable HTTP.\n

8 Tools
\n

\n
\n\n
\n\n[![Version](https://img.shields.io/badge/Version-0.2.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/federal-reserve-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.2.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/federal-reserve-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/federal-reserve-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.2-blueviolet.svg?style=flat-square)](https://bun.sh/)\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/federal-reserve-mcp-server/releases/latest/download/federal-reserve-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=federal-reserve-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvZmVkZXJhbC1yZXNlcnZlLW1jcC1zZXJ2ZXIiXX0=) [![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%22federal-reserve-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Ffederal-reserve-mcp-server%22%5D%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\nFederal Reserve economic data from the FRED API (Federal Reserve Bank of St. Louis) — ~800K time series covering output, prices, employment, money, rates, housing, trade, and international macro. Search series, fetch metadata and observations, browse the category tree, look up releases, and query large result sets with SQL over DataCanvas. Runs as a stdio process or a local Streamable HTTP server.\n\n### Tools\n\n| Tool | Description |\n|:-----|:------------|\n| `fedreserve_search_series` | Full-text search across FRED series titles, tags, and notes |\n| `fedreserve_get_series` | Fetch metadata for one or more series — title, units, frequency, observation range |\n| `fedreserve_get_observations` | Fetch date+value observations for one or more series, with date-range and unit-transform filtering |\n| `fedreserve_browse_categories` | Navigate the FRED category tree |\n| `fedreserve_get_release` | Look up a FRED release by ID or name search, with its associated series |\n| `fedreserve_dataframe_describe` | List active DataCanvas dataframes with provenance, schema, and row count |\n| `fedreserve_dataframe_query` | Run a SELECT against registered DataCanvas dataframes via DuckDB SQL |\n| `fedreserve_dataframe_drop` | Drop a DataCanvas dataframe by name (opt-in) |\n\n## Capability reference\n\n### `fedreserve_search_series` tool\n\n- Full-text or series-ID search, with `frequency`, `units`, `seasonal_adjustment`, and `tag_names` filters\n- Pagination via `limit` (default and max 1000) and `offset` (max 4999; FRED caps searchable results at 5000)\n- Output includes `active_filters` when applied and `popularity` (0–100) when FRED provides it; empty results suggest a broader query or category browsing\n\n---\n\n### `fedreserve_get_series` tool\n\n- Accepts a single series ID or up to 50 in one call; fires parallel upstream requests (no FRED batch endpoint exists)\n- Returns title, units, frequency, seasonal adjustment, observation range, popularity, and notes per series\n- Partial-batch failures land in a `failed` array with per-ID error messages; a single unresolved ID throws `series_not_found` instead\n\n---\n\n### `fedreserve_get_observations` tool\n\n- Accepts one series ID or up to 10, with `observation_start` / `observation_end`, native unit transforms, and frequency downsampling via `aggregation_method` (`avg`, `sum`, `eop`)\n- Returns date/value observations with string values that preserve trailing zeros, plus per-series failures\n- Multi-series or >500-row results spill to DataCanvas, returning `dataset.name` for `fedreserve_dataframe_query`; without canvas, returns a truncated inline preview\n\n---\n\n### `fedreserve_browse_categories` tool\n\n- Omit `category_id` to start at the root (ID 0); returns the category, its child categories, and — for a leaf with no children — a sample of up to 10 series\n- An unknown `category_id` throws `category_not_found`\n\n---\n\n### `fedreserve_get_release` tool\n\n- Exactly one of `release_id` (integer) or `release_search` (case-insensitive substring, filtered client-side — FRED has no server-side release search) is required\n- Returns release name, link, notes, upcoming scheduled dates, and a paginated series list (`series_limit` max 1000, `series_offset`)\n- An ambiguous name search returns up to 10 `search_alternatives` instead of guessing; retry with the exact `release_id`\n\n---\n\n### `fedreserve_dataframe_describe` tool\n\n- Lists active DataCanvas dataframes for the tenant, or one by `name`, newest first\n- Each entry carries `source_tool`, `query_params`, `created_at`, `expires_at`, `row_count`, `truncated` / `max_rows`, and `column_schema`\n\n---\n\n### `fedreserve_dataframe_query` tool\n\n- Runs a single read-only DuckDB SELECT against `df_` tables, including joins, aggregates, window functions, and CTEs; external files and system catalogs are blocked\n- `row_limit` caps returned rows (default 1000, max 10000); `preview` sets the inline sample. BIGINT results serialize as strings\n- Optional `register_as` persists the result as a new dataframe with its own TTL for further queries\n\n---\n\n### `fedreserve_dataframe_drop` tool\n\n- Opt-in — enabled when `FRED_DATAFRAME_DROP_ENABLED=true`; otherwise registered as a disabled tool card (visibility depends on the client's protocol version)\n- Drops the named dataframe early; returns `dropped: false` when absent. TTL also reclaims expired tables\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\nFRED-specific:\n\n- Dataframe tools require `CANVAS_PROVIDER_TYPE=duckdb` and report `canvas_unavailable` otherwise\n- `FRED_API_KEY`-gated access to the St. Louis Fed's FRED API (`api.stlouisfed.org/fred`) at up to 120 requests/minute\n- Parallel multi-series fetching via `Promise.allSettled`, with partial success reported per ID rather than failing the whole batch\n- DataCanvas spillover for multi-series or >500-row observation results, queryable via `fedreserve_dataframe_query`\n- FRED's native unit transformations and frequency downsampling delegated server-side for precision against the full series history\n- Category tree navigation across all FRED domains — Money & Banking, National Accounts, Employment, Prices, Housing, Trade, and more\n\nAgent-friendly output:\n\n- Graceful partial failure — `fedreserve_get_series` and `fedreserve_get_observations` return per-ID `failed` rows with error messages instead of failing the whole request\n- Ambiguous-input disambiguation — `fedreserve_get_release`'s name search returns typed `search_alternatives` instead of guessing when multiple releases match\n- Provenance on DataCanvas output — every dataframe carries `source_tool`, `query_params`, and TTL fields so agents can reason about where staged data came from and how long it's valid\n- Degrades gracefully — `fedreserve_get_observations` falls back to a truncated inline preview with an explanatory `message` when DataCanvas isn't configured, rather than failing\n\n## Getting started\n\nAdd the following to your MCP client configuration file. Obtain a free FRED API key at [research.stlouisfed.org/docs/api/api_key.html](https://research.stlouisfed.org/docs/api/api_key.html).\n\n```json\n{\n \"mcpServers\": {\n \"federal-reserve-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/federal-reserve-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\",\n \"FRED_API_KEY\": \"your-api-key\"\n }\n }\n }\n}\n```\n\nOr with npx (no Bun required):\n\n```json\n{\n \"mcpServers\": {\n \"federal-reserve-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cyanheads/federal-reserve-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\",\n \"FRED_API_KEY\": \"your-api-key\"\n }\n }\n }\n}\n```\n\nOr with Docker:\n\n```json\n{\n \"mcpServers\": {\n \"federal-reserve-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\",\n \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n \"-e\", \"FRED_API_KEY=your-api-key\",\n \"ghcr.io/cyanheads/federal-reserve-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_HTTP_PORT=3010 FRED_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 FRED API key from [stlouisfed.org](https://fredaccount.stlouisfed.org/login/secure/). The key grants 120 requests/minute.\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/federal-reserve-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd federal-reserve-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 FRED_API_KEY\n```\n\n## Configuration\n\nAll configuration is validated at startup via Zod schemas in `src/config/server-config.ts`.\n\n| Variable | Description | Default |\n|:---------|:------------|:--------|\n| `FRED_API_KEY` | **Required.** API key from [stlouisfed.org](https://research.stlouisfed.org/docs/api/api_key.html). | — |\n| `FRED_BASE_URL` | Override the FRED API base URL. | `https://api.stlouisfed.org/fred` |\n| `FRED_DATASET_TTL_SECONDS` | Sliding TTL for DataCanvas-registered observation tables (seconds). | `86400` |\n| `FRED_DATAFRAME_DROP_ENABLED` | Set `true` to enable `fedreserve_dataframe_drop`; otherwise registered as disabled. | `false` |\n| `CANVAS_PROVIDER_TYPE` | Set to `duckdb` to enable DataCanvas SQL querying for observation results. | — |\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |\n| `MCP_HTTP_PORT` | Port for HTTP server. | `3010` |\n| `MCP_SESSION_MODE` | HTTP session posture: `auto`, `stateful`, or `stateless`. Declared as `stateless` in `src/index.ts` — no tool holds per-session state. | `stateless` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |\n| `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |\n| `LOGS_DIR` | Directory for log files (Node.js only). | `/logs` |\n| `STORAGE_PROVIDER_TYPE` | Storage backend. | `in-memory` |\n| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry). | `false` |\n| `OTEL_EXPORTER_OTLP_ENDPOINT` | Base OTLP URL for traces (`/v1/traces`) and metrics (`/v1/metrics`). | — |\n| `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` | Opt-in OTLP log endpoint, used as-is; the base endpoint does not enable logs. | — |\n| `LOG_TOOL_FAILURE_PAYLOADS` | Log failed tool arguments and results with key-name redaction; secrets in free-form values are not redacted. | `false` |\n| `LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES` | Per-payload UTF-8 byte cap for failed-call logging. | `16384` |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides.\n\nSet `CANVAS_PROVIDER_TYPE=duckdb` to enable SQL over observation tables. npm installs and Docker images include the DuckDB runtime. Portable Claude Desktop bundles omit native bindings; use the npm or Docker installation for canvas mode.\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 federal-reserve-mcp-server .\ndocker run --rm -e FRED_API_KEY=your-key -e MCP_TRANSPORT_TYPE=http -p 3010:3010 federal-reserve-mcp-server\n```\n\nThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/federal-reserve-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 and inits services. |\n| `src/config` | Server-specific environment variable parsing and validation with Zod. |\n| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Eight tools across FRED domain and DataCanvas. |\n| `src/services/fred` | FRED API service — HTTP client, retry, 429 handling, key injection. |\n| `src/services/canvas-bridge` | DataCanvas adapter — table naming, TTL/provenance tracking, SQL gate extras. |\n| `tests/` | Unit and integration tests mirroring `src/`. |\n| `docs/` | Design and planning documents. |\n\n## Development guide\n\nSee [`CLAUDE.md`](./CLAUDE.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 in `src/mcp-server/tools/definitions/index.ts`\n- Wrap FRED API calls: validate raw response → 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"}