{"_id":"@cyanheads/exchange-rates-mcp-server","_rev":"13-e220d6d6fc62ff9a086b62de53ffe940","name":"@cyanheads/exchange-rates-mcp-server","dist-tags":{"latest":"0.4.2"},"versions":{"0.1.1":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.1.1","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/exchange-rates-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.1.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"1efc8208d70b66ba2cd948d9243eeeeaa3e79dba","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.1.1.tgz","fileCount":77,"integrity":"sha512-Mdep72Hu+lhhg64IUIaoVx4xOuvvYerRlMiKwPTCwUwRtRLdLT6iUn4wcO/ZQ4WqMTIVfdJoEVCo/rZsKLkHRQ==","signatures":[{"sig":"MEUCIDk/WiXTeAFOTwlmn/vTSHVKdPJMGeyc1dBMsPtcnbmpAiEAoVfYbP8E8rpWErJi65Cpd8ia78815GqfsnrS2AgB/Gk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":210861},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"1efc8208d70b66ba2cd948d9243eeeeaa3e79dba","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/exchange-rates-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":"npm run build && npx -y @anthropic-ai/mcpb pack . dist/exchange-rates-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-Mdep72Hu+lhhg64IUIaoVx4xOuvvYerRlMiKwPTCwUwRtRLdLT6iUn4wcO/ZQ4WqMTIVfdJoEVCo/rZsKLkHRQ==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.3-r.3","@cyanheads/mcp-ts-core":"^0.9.21"},"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.1","@biomejs/biome":"^2.4.16"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.1.1_1780660730441_0.46720160258954446","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.1.2","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/exchange-rates-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.1.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"61a095a2d379926bb5db9dc1581614682507a379","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.1.2.tgz","fileCount":78,"integrity":"sha512-VyTCXthvb4EcOCtNrLKYNHxs2uYNz6MTGCAfFQ/D1WSNcPbFA4XWc7TDG44TpJNLadi9S7Ghe2dfDfiD/UNR6w==","signatures":[{"sig":"MEUCIQCs3Atg6sDYy2q5wSiN3p42Wp4Y9g8ZtE8WZQ1g2T4DGwIgZtFHXYG0nr7mUMS1hxYUhp+PTXzh4BuliH7uVTnSRTc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":212173},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"61a095a2d379926bb5db9dc1581614682507a379","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/exchange-rates-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":"npm run build && npx -y @anthropic-ai/mcpb pack . dist/exchange-rates-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-VyTCXthvb4EcOCtNrLKYNHxs2uYNz6MTGCAfFQ/D1WSNcPbFA4XWc7TDG44TpJNLadi9S7Ghe2dfDfiD/UNR6w==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.3-r.3","@cyanheads/mcp-ts-core":"^0.9.21"},"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.2","@biomejs/biome":"^2.4.16"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.1.2_1780783478944_0.9463284702159331","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.1.3","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/exchange-rates-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.1.3","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"692403dde0fba18dd27ba659b1aed230156cb281","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.1.3.tgz","fileCount":79,"integrity":"sha512-hKOx7rYin/UTcp972UP+NX2Ju2KcsmjlyOFWFVyH+lniklXCDpP2tnC/DQrn34XFHBCHbqJXR6aUwpzHWuexAg==","signatures":[{"sig":"MEUCIQD35JsZhod0IR2WHPgE71yaufZ3omZ4ADTiVf/ABACp9wIgeJUKreOy8zaH89PWjhcuUtu8YFdHRdbOzJbwSZwDKuY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":212963},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"692403dde0fba18dd27ba659b1aed230156cb281","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/exchange-rates-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":"npm run build && npx -y @anthropic-ai/mcpb pack . dist/exchange-rates-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-hKOx7rYin/UTcp972UP+NX2Ju2KcsmjlyOFWFVyH+lniklXCDpP2tnC/DQrn34XFHBCHbqJXR6aUwpzHWuexAg==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.3-r.3","@cyanheads/mcp-ts-core":"^0.9.21"},"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.2","@biomejs/biome":"^2.4.16"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.1.3_1780813918576_0.3404273566093643","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.1.4","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/exchange-rates-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.1.4","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"d3f2f67c9f7d03598f3d89bd6192b13226243fb9","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.1.4.tgz","fileCount":80,"integrity":"sha512-qxZYLMZxKuGA2cvXvZykjR5DCJM9H838dmo/i1dxgsgOZ4bAh6e7Iy7MYrbHlakg1mdYlFQoAjWeo3t2LhsE9g==","signatures":[{"sig":"MEUCIFc17UWxPTyMoGWeEj6MTGoWiFNGE5XnblV70u/SCpSJAiEAxwxE5OpHgMa7MOkAxGW2HVTiuNr9PK1y2L4i5kQsMz8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":218045},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"d3f2f67c9f7d03598f3d89bd6192b13226243fb9","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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-qxZYLMZxKuGA2cvXvZykjR5DCJM9H838dmo/i1dxgsgOZ4bAh6e7Iy7MYrbHlakg1mdYlFQoAjWeo3t2LhsE9g==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.3-r.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.4.16"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.1.4_1781249838935_0.9878346718862887","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.1.5","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"cyanheads (https://github.com/cyanheads/exchange-rates-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.1.5","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"6dbe5f3160579183a6d8b5a4ad7b92c9e29277a9","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.1.5.tgz","fileCount":81,"integrity":"sha512-xP18g5VY7I9gtSamSfmB9nYAFp3bprGKJeZ6Yn3tQiUEwldvmTsgBsj2AXFS9zBCOv7mgKCajtcN5kM/+LpTMA==","signatures":[{"sig":"MEUCIGdtxOhxrelpvwHRv/+FNT+7EFAhH6PO8bi7QBIBwehjAiEAmo8lZQPko1Quy0moG/tHP1FrfIZxHQsrvBH4t0S4ymY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":221002},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"6dbe5f3160579183a6d8b5a4ad7b92c9e29277a9","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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-xP18g5VY7I9gtSamSfmB9nYAFp3bprGKJeZ6Yn3tQiUEwldvmTsgBsj2AXFS9zBCOv7mgKCajtcN5kM/+LpTMA==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.4-r.1","@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/exchange-rates-mcp-server_0.1.5_1781955237726_0.9623666447339552","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.2.0","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.2.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"61a7ae9430789b2221cb36f2bac7b70a4b27b043","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.2.0.tgz","fileCount":86,"integrity":"sha512-K3MPK7CT31FKsTMXScPeYFHQ5DnecwXTIC1pZuGzKmPoZ96+gxGrBdR/RL0z9LtgFOEe+ST14Qsnqls02bejpg==","signatures":[{"sig":"MEYCIQDZw060YLcCpuldrqWzOv7cw+/A4cuU+rH6vTu0shSJxwIhAMLWW1u0Pr0SNAU19AHePOMgY/0FKVaaWgR9zZBcYQ/G","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":269065},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"61a7ae9430789b2221cb36f2bac7b70a4b27b043","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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-K3MPK7CT31FKsTMXScPeYFHQ5DnecwXTIC1pZuGzKmPoZ96+gxGrBdR/RL0z9LtgFOEe+ST14Qsnqls02bejpg==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.5-r.1","@cyanheads/mcp-ts-core":"^0.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.14","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.10","depcheck":"^1.4.7","tsc-alias":"^1.9.1","typescript":"^7.0.2","@types/node":"26.1.1","@biomejs/biome":"2.5.5","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.2.0_1785521237164_0.892735229074908","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.2.1","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.2.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"7cb1c402273edeb33dca3029d3b5fafc7927ef8a","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.2.1.tgz","fileCount":87,"integrity":"sha512-QHp98W/FoOrxyfpQWu6AwU+qiffnFGZAXVitRqlRC/EoixayCTtpQFlUF84Vv/GKuUeJI9kSWUdKLzFmNw7JQA==","signatures":[{"sig":"MEQCIAFbILXsB3xeOdm4cA2VhblSnHCfqDlTEosMn+R9DzOoAiBrGqTQZhrIhCQksmOcpfpgWmHwWVk4wFi8ReQRshRPrg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":270530},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"7cb1c402273edeb33dca3029d3b5fafc7927ef8a","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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-QHp98W/FoOrxyfpQWu6AwU+qiffnFGZAXVitRqlRC/EoixayCTtpQFlUF84Vv/GKuUeJI9kSWUdKLzFmNw7JQA==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.5-r.1","@cyanheads/mcp-ts-core":"^0.11.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.14","devDependencies":{"ignore":"^7.0.6","vitest":"^4.1.10","depcheck":"^1.4.7","tsc-alias":"^1.9.1","typescript":"^7.0.2","@types/node":"26.1.1","@biomejs/biome":"2.5.5","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.2.1_1785522038259_0.08004212387955723","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.3.0","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.3.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"3e5d6e77e81ec78c08eae9492ccc5d9028ec4a25","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.3.0.tgz","fileCount":92,"integrity":"sha512-+MQW7y5xqF2qa6DJ7oFlokIuwEZkQmGJcmnXEvBc7tkXHNi4CyHeMXgjRQk/bh2WMsdVZreDrcHSHI+wMDqI/g==","signatures":[{"sig":"MEUCIGUhJchliaUDQghW6btm98iKYYrIiHgFWPBfT7dAkhoDAiEAs12hVep2wxpgIE6/YE7f707FZa+adAKjafuRsv5MVgE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":289429},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"3e5d6e77e81ec78c08eae9492ccc5d9028ec4a25","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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-+MQW7y5xqF2qa6DJ7oFlokIuwEZkQmGJcmnXEvBc7tkXHNi4CyHeMXgjRQk/bh2WMsdVZreDrcHSHI+wMDqI/g==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.5-r.4","@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.10","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.3.0_1787636535986_0.09776408912307999","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.3.1","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.3.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"cf952616ba1a39ef97f78f0ee5cff1eb989b777a","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.3.1.tgz","fileCount":93,"integrity":"sha512-D/Xrf7lVYjxlIAGNVwubw+Q140ukXRW4CphtVn0FrKE3XzUVQzZlQTrUrFMDLDp8NFOzzPxmsQLfs9zaKbZBoQ==","signatures":[{"sig":"MEQCIHiv3bxQPRNyTjd3B4b2aGkFF/qi7dxnHSiVf2cQCXg4AiArPhh9AtgReGE1kiNElQEzXOV+2c0mrPPeO6WSLOZE8g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":290110},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"cf952616ba1a39ef97f78f0ee5cff1eb989b777a","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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-D/Xrf7lVYjxlIAGNVwubw+Q140ukXRW4CphtVn0FrKE3XzUVQzZlQTrUrFMDLDp8NFOzzPxmsQLfs9zaKbZBoQ==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.5-r.4","@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.10","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.3.1_1787636957607_0.9536450086274351","host":"s3://npm-registry-packages-npm-production"}},"0.3.2":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.3.2","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.3.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"f3bb91cf2f5cab31a6bc08ad928726c794f6519c","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.3.2.tgz","fileCount":94,"integrity":"sha512-UL2FUFm/5feFbzTwYwmcq7RPIa6fIXZFnq0iOf6HD109BujPzYUD+YDG3U6JdJpYYyqnfN1O5bcMBoPj1VBL3Q==","signatures":[{"sig":"MEUCIQCGcrRfZGkNMPxOufZ3es2iRXiv40z17QjU7ocXyM7gSAIgaxsKcPvTdV/HzpCBrzstGZK2Cq7ZelfpCiIeg4m41nI=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDb8jCTXX7h54uMuwj0Qjl/XVeyTyVAes4Nakl4Uj6MmQIhAIfsI1uW6gUV/R5HuDTZtlqwFtbKCcnm43i1cxpmYg+Z","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":299144},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"f3bb91cf2f5cab31a6bc08ad928726c794f6519c","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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-UL2FUFm/5feFbzTwYwmcq7RPIa6fIXZFnq0iOf6HD109BujPzYUD+YDG3U6JdJpYYyqnfN1O5bcMBoPj1VBL3Q==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.0","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.5-r.4","@cyanheads/mcp-ts-core":"0.12.8"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.9","vitest":"^5.0.0","depcheck":"^1.4.7","tsc-alias":"^1.9.4","typescript":"^7.0.2","@types/node":"26.5.1","@biomejs/biome":"2.5.12","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.3.2_1789247035556_0.018934807973381984","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.4.0","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.4.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"a4fbbfff05561b12e38cd15442d5a356e11f4568","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.4.0.tgz","fileCount":99,"integrity":"sha512-0X5fzUFlFJX1+Zg1SeQCsquZFC+seqgguO9u1KTZnYO0WugtKGsU+j7R6rHit94ny4/yEpOXHvrKh/qYw2znAA==","signatures":[{"sig":"MEUCIF9mANwa0EMTgw4sik62thhO+N214+YS9pXy49ttIOYtAiEArzeJps5JPThgURVgzQ9Iw0t4Yr10rgb+35imDcSo/Eo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIEQQjXFd51OwPT5kSjr20t+GXzkoIKauZMfe/Hben44YAiEApC8/2hrZR1Qj2pDqxr+UwrHxfsLd3TiJYEIS4gposyg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":311327},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"a4fbbfff05561b12e38cd15442d5a356e11f4568","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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-0X5fzUFlFJX1+Zg1SeQCsquZFC+seqgguO9u1KTZnYO0WugtKGsU+j7R6rHit94ny4/yEpOXHvrKh/qYw2znAA==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.0","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.5-r.4","@cyanheads/mcp-ts-core":"0.12.8"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.0","devDependencies":{"ignore":"^7.0.9","vitest":"^5.0.0","depcheck":"^1.4.7","tsc-alias":"^1.9.4","typescript":"^7.0.2","@types/node":"26.5.1","@biomejs/biome":"2.5.12","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.4.0_1789249224994_0.5526169799169727","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"@cyanheads/exchange-rates-mcp-server","version":"0.4.1","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/exchange-rates-mcp-server@0.4.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"bin":{"exchange-rates-mcp-server":"dist/index.js"},"dist":{"shasum":"708dd403ce62b5737b106d76b574db9fbe5ff2ef","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.4.1.tgz","fileCount":100,"integrity":"sha512-ZN56UyCVkpyqfKmF810h0HNcAMbFh1mLm2Wwq1FUm0OCAp0Cyby/MWubg7TJF5dX82F5gZU3IgpOMBnacqOr+A==","signatures":[{"sig":"MEUCIAHro1lM0raj2ferZDrwFCzwVrGPLN4s16lUbXm35q8LAiEA4BjG7LVH9vxtIDb652635F+6MWzzIUTEFkn4ccRsUKo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIDMzteZlwh2SGp1ej+oXnIbPBTKhXMApyb8uOpMj5oXYAiEAmecLlW0RD8ryHYDSIfAzJ2Z3rrSdm1EyLp+WZ6c9+B8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":320247},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"708dd403ce62b5737b106d76b574db9fbe5ff2ef","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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"},"_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"_integrity":"sha512-ZN56UyCVkpyqfKmF810h0HNcAMbFh1mLm2Wwq1FUm0OCAp0Cyby/MWubg7TJF5dX82F5gZU3IgpOMBnacqOr+A==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","pino-pretty":"^13.1.3","@duckdb/node-api":"^1.5.5-r.5","@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.5.1","@biomejs/biome":"2.5.14","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/exchange-rates-mcp-server_0.4.1_1789843833520_0.3855395095828358","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"_id":"@cyanheads/exchange-rates-mcp-server@0.4.2","bin":{"exchange-rates-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"dist":{"shasum":"00e01416002d728279142cb1cd5443f687bad998","tarball":"https://registry.npmjs.org/@cyanheads/exchange-rates-mcp-server/-/exchange-rates-mcp-server-0.4.2.tgz","fileCount":101,"integrity":"sha512-2g21LpTqQkvsQHuTHHNIlTFqZ2gZPaqVxi0ZNVk1dOmFvsoejmzHwD0oZ/pMLnVQFuVjGDJwHH/6I84YrpbtNg==","signatures":[{"sig":"MEUCIQC7r8aNOJ9OMjT4jk2sqhEgleIH0GwmsM+3tfl944811AIgcmRpN6AmgVS4VEqXwJGy+01rl/ddedRK/KV8xLzBots=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIET5cUwMCcBJnKqLuaUL3Ro1qSM2yCn6Mn7/vtY0GJFJAiEAx0VuBbegrZ316lwDChf4rmj4CF1Vi4Mng5vOFBIu4Gc="}],"unpackedSize":327970},"main":"dist/index.js","name":"@cyanheads/exchange-rates-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand (https://caseyjhand.com)","shasum":"00e01416002d728279142cb1cd5443f687bad998","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/exchange-rates-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/exchange-rates-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/exchange-rates-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.4.2","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"_integrity":"sha512-2g21LpTqQkvsQHuTHHNIlTFqZ2gZPaqVxi0ZNVk1dOmFvsoejmzHwD0oZ/pMLnVQFuVjGDJwHH/6I84YrpbtNg==","repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Convert currencies, get FX rates, and query historical ECB exchange rate data 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","@socketsecurity/bun-security-scanner":"^1.1.3"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/exchange-rates-mcp-server_0.4.2_1791099373472_0.0567498339937631"}}},"time":{"created":"2026-06-05T11:58:50.306Z","modified":"2026-10-04T07:36:13.955Z","0.1.1":"2026-06-05T11:58:50.582Z","0.1.2":"2026-06-06T22:04:39.088Z","0.1.3":"2026-06-07T06:31:58.752Z","0.1.4":"2026-06-12T07:37:19.156Z","0.1.5":"2026-06-20T11:33:57.914Z","0.2.0":"2026-07-31T18:07:17.284Z","0.2.1":"2026-07-31T18:20:38.483Z","0.3.0":"2026-08-25T05:42:16.149Z","0.3.1":"2026-08-25T05:49:17.757Z","0.3.2":"2026-09-12T21:03:55.654Z","0.4.0":"2026-09-12T21:40:25.083Z","0.4.1":"2026-09-19T18:50:33.619Z","0.4.2":"2026-10-04T07:36:13.567Z"},"bugs":{"url":"https://github.com/cyanheads/exchange-rates-mcp-server/issues"},"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/exchange-rates-mcp-server#readme","keywords":["exchange-rates","currency-conversion","fx","forex","ecb","frankfurter","fiat","mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent"],"repository":{"url":"git+https://github.com/cyanheads/exchange-rates-mcp-server.git","type":"git"},"description":"Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"
\n

@cyanheads/exchange-rates-mcp-server

\n

Convert currencies, get FX rates, and query historical ECB exchange rate data via MCP. STDIO or Streamable HTTP.\n

7 Tools • 1 Opt-in Tool • 2 Resources
\n

\n
\n\n
\n\n[![Version](https://img.shields.io/badge/Version-0.4.2-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/exchange-rates-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/exchange-rates-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/exchange-rates-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
\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/exchange-rates-mcp-server/releases/latest/download/exchange-rates-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=exchange-rates-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvZXhjaGFuZ2UtcmF0ZXMtbWNwLXNlcnZlciJdfQ==) [![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%22exchange-rates-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Fexchange-rates-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**Public Hosted Server:** [https://exchange-rates.caseyjhand.com/mcp](https://exchange-rates.caseyjhand.com/mcp)\n\n
\n\n---\n\n## Overview\n\nECB reference exchange rates via Frankfurter — a keyless proxy covering ~30 currencies back to 1999-01-04. Convert amounts, disambiguate currency codes, and pull point-in-time or historical rates from any MCP client, with SQL analytics over long time-series when DataCanvas is enabled. Runs as a stdio process, a local Streamable HTTP server, or the public hosted endpoint above.\n\n### Tools\n\n| Tool | Description |\n|:---|:---|\n| `fx_list_currencies` | List all ~30 ECB-supported ISO 4217 currencies with full names |\n| `fx_get_rates` | Snapshot of all rates for a base currency at latest or a historical date |\n| `fx_get_rate` | Exchange rate for a single currency pair at latest or a historical date |\n| `fx_convert_currency` | Convert an amount between two currencies at latest or a historical rate |\n| `fx_get_timeseries` | Historical daily rates for a currency pair over a date range |\n| `fx_dataframe_describe` | List DataCanvas tables and columns staged by a prior `fx_get_timeseries` call |\n| `fx_dataframe_query` | Run a read-only SQL SELECT against a staged DataCanvas table |\n| `fx_dataframe_drop` | Remove one staged DataCanvas table or view (opt-in, destructive) |\n\nThe three `fx_dataframe_*` tools need `CANVAS_PROVIDER_TYPE=duckdb` — unset, they're not advertised in `tools/list` at all, and `fx_get_timeseries` returns every range inline instead. `fx_dataframe_drop` additionally needs `FX_ENABLE_CANVAS_DROP=true`.\n\n### Resources\n\n| Resource | Description |\n|:---|:---|\n| `fx://currencies` | All supported currencies as a stable reference document |\n| `fx://rates/latest/{base}` | Latest rates snapshot for a base currency as a stable URI |\n\nAll resource data is also reachable via tools — use `fx_list_currencies` or `fx_get_rates` for programmatic access.\n\n## Capability reference\n\n### `fx_list_currencies` tool\n\n- No input parameters\n- Returns `[{ code, name }]` for all ~30 ECB-scoped currencies, sorted alphabetically by code\n- ECB coverage shifts as currencies enter or exit scope — call this to validate a user-supplied code rather than hard-coding a list\n\n---\n\n### `fx_get_rates` tool\n\n- `base_currency` required; `date` optional (default latest, ECB data from 1999-01-04, no future dates); optional `symbols` array narrows the response and must name at least one code\n- Returns a `rates` map (quote code → rate), the actual `rate_date`, and `date_snapped: true` when a weekend/holiday request snapped to the prior business day\n- Naming the base currency in `symbols` is valid — answered locally with a rate of 1 rather than sent upstream\n- Typed failures: `invalid_date_format`, `unsupported_currency`, `date_out_of_range`, `upstream_no_data`\n\n---\n\n### `fx_get_rate` tool\n\n- `base_currency`, `quote_currency` required; `date` optional (default latest, ECB data from 1999-01-04, no future dates)\n- Returns `rate`, `rate_date`, and `date_snapped: true` when a weekend/holiday request snapped to the prior business day\n- Cross-rates (neither side EUR) triangulate through EUR in one upstream call; a same-currency pair returns a rate of 1 without reaching the API, still dated to the real publication day\n- Typed failures: `invalid_date_format`, `unsupported_currency`, `date_out_of_range`, `upstream_no_data`\n\n---\n\n### `fx_convert_currency` tool\n\n- `base_currency`, `quote_currency`, `amount` (must be > 0) required; `date` optional (default latest, ECB data from 1999-01-04, no future dates)\n- Handles EUR↔any, any↔EUR, and cross-rate pairs (e.g. USD→JPY) in a single upstream call\n- Returns `quote_amount` (rounded to 6 decimal places), `rate`, `rate_date`, `date_snapped`, plus `rate_type` and `source` provenance\n- Typed failures: `invalid_date_format`, `unsupported_currency`, `date_out_of_range`, `upstream_no_data`\n\n---\n\n### `fx_get_timeseries` tool\n\n- `base_currency`, `quote_currency`, `start_date`, `end_date` required (ECB data from 1999-01-04, no future dates, start ≤ end); optional `canvas_id` appends to an existing canvas\n- Inline results page at 500 publication days — `rate_count` is always the range total; `truncated: true` plus `next_start_date` continue the page\n- Ranges over `FX_TIMESERIES_CANVAS_THRESHOLD_DAYS` (default 90 days) spill to DataCanvas when configured — response carries `spilled: true`, `canvas_id`, `table_name`; without DataCanvas they're paged inline instead\n- A same-currency pair returns a rate of 1 on each real ECB publication day in range, not a synthetic Mon–Fri loop\n- An empty range (only weekends/holidays) returns `rate_count: 0` with an explanatory `notice`, distinguishable from an error\n\n---\n\n### `fx_dataframe_describe` tool\n\n- `canvas_id` required (from a prior `fx_get_timeseries` call)\n- Returns each staged table's `kind`, `row_count`, and column schema (`name`, `type`, `nullable`), plus `expires_at`\n- Required first step before `fx_dataframe_query`; needs `CANVAS_PROVIDER_TYPE=duckdb` — unregistered otherwise\n- `canvas_not_found` when the ID doesn't exist or has expired\n\n---\n\n### `fx_dataframe_query` tool\n\n- `canvas_id` and a read-only SQL `query` required; `row_limit` optional (1–10,000, default 150)\n- Supports aggregations, GROUP BY, window functions, and JOINs across tables from multiple `fx_get_timeseries` calls\n- Returns at most `row_limit` rows; `truncated: true` plus a `notice` give the `ORDER BY LIMIT OFFSET ` shape for the next page — ORDER BY is required for stable paging\n- Markdown table cells are escaped so pipes, angle brackets, and line breaks stay inside their cell; `structuredContent` keeps raw values\n- Needs `CANVAS_PROVIDER_TYPE=duckdb`; typed failures: `canvas_not_found`, `missing_table`, `invalid_query`\n\n---\n\n### `fx_dataframe_drop` tool\n\n- `canvas_id` and exact `table_name` (from `fx_dataframe_describe`) required\n- Removes one staged table or view; ECB rate data is untouched and the series can be re-staged via `fx_get_timeseries`\n- Returns `dropped: true`/`false` depending on whether the table existed\n- Disabled unless `FX_ENABLE_CANVAS_DROP=true` — otherwise absent from `tools/list`, named with its enable hint only in the startup log and the HTTP landing page; also needs `CANVAS_PROVIDER_TYPE=duckdb`\n\n---\n\n### `fx://currencies` resource\n\n- No parameters; returns `currencies`, `count`, `source` as `application/json` — the same payload as `fx_list_currencies`\n- Listed as a single static resource\n\n---\n\n### `fx://rates/latest/{base}` resource\n\n- `base` is an ISO 4217 currency code in the URI\n- Returns `base_currency`, `rate_date`, a `rates` map, `rate_type`, and `source` for the latest ECB fix\n- Listed with four sample URIs (EUR, USD, GBP, JPY) as discovery hints\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\nECB-specific:\n\n- Keyless access via [Frankfurter](https://www.frankfurter.dev/) — a Cloudflare-fronted ECB proxy; no API keys required\n- Cross-rate triangulation: any pair works — USD → JPY is one upstream call, cross-rated through EUR on Frankfurter's side\n- Weekend/holiday date semantics: `date_snapped` surfaces when the API returns a different date than requested\n- Identity pairs never reach the upstream API: a currency against itself returns a rate of 1, dated to the day the ECB actually published for that currency rather than to the calendar date requested\n- Long time-series spill to DataCanvas (DuckDB) when enabled, for SQL aggregation over the full range\n\nAgent-friendly output:\n\n- Rate provenance on every response — `rate_type`, `source`, `rate_date`, and `date_snapped` so agents can reason about trust and freshness\n- Structured error contracts — typed `reason` fields (`unsupported_currency`, `date_out_of_range`, `invalid_query`, …) let callers branch on failure type, not string parsing\n- Bounded responses — inline time-series pages continue from `next_start_date`, and SQL results cap at `row_limit`, so no call returns an unbounded payload\n- Success-path `notice` enrichment — explains an empty series, where to continue a paged series, or which tools read a staged one, so a legitimate zero-result never reads as a failure\n\n---\n\n## Getting started\n\n### Public Hosted Instance\n\nA public instance is available at `https://exchange-rates.caseyjhand.com/mcp` — no installation required. Point any MCP client at it via Streamable HTTP:\n\n```json\n{\n \"mcpServers\": {\n \"exchange-rates-mcp-server\": {\n \"type\": \"streamable-http\",\n \"url\": \"https://exchange-rates.caseyjhand.com/mcp\"\n }\n }\n}\n```\n\n### Self-Hosted / Local\n\nNo API key required — Frankfurter is keyless. Add the following to your MCP client configuration file:\n\n```json\n{\n \"mcpServers\": {\n \"exchange-rates-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/exchange-rates-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\"\n }\n }\n }\n}\n```\n\nOr with npx (no Bun required):\n\n```json\n{\n \"mcpServers\": {\n \"exchange-rates-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cyanheads/exchange-rates-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"MCP_LOG_LEVEL\": \"info\"\n }\n }\n }\n}\n```\n\nOr with Docker:\n\n```json\n{\n \"mcpServers\": {\n \"exchange-rates-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\",\n \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n \"ghcr.io/cyanheads/exchange-rates-mcp-server:latest\"\n ]\n }\n }\n}\n```\n\nTo enable DataCanvas for long time-series SQL analytics — which also registers `fx_dataframe_describe` and `fx_dataframe_query`, skipped from `tools/list` otherwise — add `CANVAS_PROVIDER_TYPE=duckdb`:\n\n```json\n{\n \"mcpServers\": {\n \"exchange-rates-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/exchange-rates-mcp-server@latest\"],\n \"env\": {\n \"MCP_TRANSPORT_TYPE\": \"stdio\",\n \"CANVAS_PROVIDER_TYPE\": \"duckdb\"\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 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- No API key — Frankfurter is free and keyless.\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/exchange-rates-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd exchange-rates-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 as needed (all vars are optional — no keys required)\n```\n\n---\n\n## Configuration\n\nAll configuration is validated at startup via Zod schemas. Environment variables:\n\n| Variable | Description | Default |\n|:---------|:------------|:--------|\n| `FRANKFURTER_BASE_URL` | Frankfurter API base URL. Override for local testing or a self-hosted instance. | `https://api.frankfurter.dev/v1` |\n| `FX_TIMESERIES_CANVAS_THRESHOLD_DAYS` | Day range above which `fx_get_timeseries` spills to DataCanvas, when one is configured. | `90` |\n| `FX_ENABLE_CANVAS_DROP` | Enable the destructive `fx_dataframe_drop` tool. Off by default: the tool is not registered and is absent from `tools/list`. | `false` |\n| `CANVAS_PROVIDER_TYPE` | Canvas engine. Set to `duckdb` to enable DataCanvas for `fx_get_timeseries` long-range spillover and to register the three `fx_dataframe_*` tools. At `none` they are skipped from `tools/list`. | `none` |\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |\n| `MCP_HTTP_PORT` | Port for HTTP server. | `3010` |\n| `MCP_SESSION_MODE` | HTTP session mode: `auto`, `stateful`, or `stateless`. The server declares `stateless` in code — no handler here asks the client for input mid-call, so nothing needs a session to resume — and setting this variable overrides that declaration. | `stateless` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |\n| `MCP_REQUEST_STATE_KEY` | Opt-in key (≥ 32 bytes, the same on every instance) that seals the `requestState` a handler returns between rounds. No tool here returns one. | — |\n| `MCP_LOG_LEVEL` | Log level (RFC 5424: `debug`, `info`, `notice`, `warning`, `error`). Also the floor for logs mirrored to the client. | `info` |\n| `LOG_TOOL_FAILURE_PAYLOADS` | Log each failed tool call's arguments and result (redacted by key name only). | `false` |\n| `LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES` | Per-payload cap for `LOG_TOOL_FAILURE_PAYLOADS`, in UTF-8 bytes. | `16384` |\n| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry). | `false` |\n| `OTEL_EXPORTER_OTLP_ENDPOINT` | OTLP base URL; traces go to `/v1/traces`, metrics to `/v1/metrics`. | — |\n| `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` | Opt-in OTLP log export (e.g. `http://localhost:4318/v1/logs`); the base endpoint never enables it. | — |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides including storage, session, and telemetry vars.\n\n---\n\n## Running the server\n\n### Local development\n\n- **Build and run:**\n\n ```sh\n bun run rebuild\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, changelog sync\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 exchange-rates-mcp-server .\ndocker run --rm -p 3010:3010 exchange-rates-mcp-server\n```\n\nThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/exchange-rates-mcp-server`. OpenTelemetry peer dependencies are installed by default — build with `--build-arg OTEL_ENABLED=false` to omit them. Production dependencies, DuckDB's native binding included, are cross-installed for the target platform in a separate `deps` stage, so multi-arch builds never run Bun under emulation and the runtime image carries only `node_modules` and `dist/`.\n\n---\n\n## Project structure\n\n| Directory | Purpose |\n|:----------|:--------|\n| `src/index.ts` | `createApp()` entry point — registers tools, resources, and canvas accessor. |\n| `src/config/` | Server-specific environment variable parsing and validation with Zod. |\n| `src/mcp-server/tools/` | Tool definitions (`*.tool.ts`) — `fx_*` tools. |\n| `src/mcp-server/resources/` | Resource definitions — `fx://currencies` and `fx://rates/latest/{base}`. |\n| `src/services/frankfurter/` | Frankfurter HTTP client, retry logic, and domain types. |\n| `src/services/canvas/` | Module-level DataCanvas accessor for `fx_get_timeseries` spillover. |\n| `src/utils/` | Output helpers — Markdown table-cell escaping for `fx_dataframe_query`. |\n| `tests/` | Unit and integration tests mirroring `src/`. |\n| `docs/` | Design document and idea notes. |\n\n---\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 and resources via the barrels in `src/mcp-server/*/definitions/index.ts`\n- Wrap external API calls: validate raw → normalize to domain type → return output schema; never fabricate missing fields\n- ECB rates are mid-market reference rates — preserve the `rate_type` provenance in every response\n\n---\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---\n\n## License\n\nApache-2.0 — see [LICENSE](LICENSE) for details.\n","readmeFilename":"README.md"}