{"_id":"@cyanheads/internet-archive-mcp-server","_rev":"7-68ed49faa8ae838475372c466879843c","name":"@cyanheads/internet-archive-mcp-server","dist-tags":{"latest":"0.3.0"},"versions":{"0.1.1":{"name":"@cyanheads/internet-archive-mcp-server","version":"0.1.1","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","internet-archive","wayback-machine","wayback","cdx","archive","web-archive","historical-data"],"author":"cyanheads (https://github.com/cyanheads/internet-archive-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/internet-archive-mcp-server@0.1.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/internet-archive-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/internet-archive-mcp-server/issues"},"bin":{"internet-archive-mcp-server":"dist/index.js"},"dist":{"shasum":"8a3af30975233fd8fca631bfb31288ea837b563a","tarball":"https://registry.npmjs.org/@cyanheads/internet-archive-mcp-server/-/internet-archive-mcp-server-0.1.1.tgz","fileCount":77,"integrity":"sha512-/fetdnBAL6UXx+8M9RF5SQ6ZaDVU28xBUmJa6Y5Ozrm9Ze1MEF/95CVT9zEoUPraQw6v8mjHt6QNUM+DC8BIvg==","signatures":[{"sig":"MEUCIQCIxadWU9ph9qZw6+ybkcl0n+gKuXcXs1K/3IMF+RJdtgIgf43pxAnAEZPfx64sk7kJqSPeBWKI5DGZACbUE8N8wyA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":222876},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"8a3af30975233fd8fca631bfb31288ea837b563a","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/internet-archive-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/internet-archive-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-/fetdnBAL6UXx+8M9RF5SQ6ZaDVU28xBUmJa6Y5Ozrm9Ze1MEF/95CVT9zEoUPraQw6v8mjHt6QNUM+DC8BIvg==","repository":{"url":"git+https://github.com/cyanheads/internet-archive-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text 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.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/internet-archive-mcp-server_0.1.1_1780661598067_0.10734683018525537","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@cyanheads/internet-archive-mcp-server","version":"0.1.2","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","internet-archive","wayback-machine","wayback","cdx","archive","web-archive","historical-data"],"author":"cyanheads (https://github.com/cyanheads/internet-archive-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/internet-archive-mcp-server@0.1.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/internet-archive-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/internet-archive-mcp-server/issues"},"bin":{"internet-archive-mcp-server":"dist/index.js"},"dist":{"shasum":"e6e01ce1cb1f30c655fc867415985d1a41b439f8","tarball":"https://registry.npmjs.org/@cyanheads/internet-archive-mcp-server/-/internet-archive-mcp-server-0.1.2.tgz","fileCount":78,"integrity":"sha512-GPIgsFeiClnFsMDC8SZeWZOe35GOo2pGzRnDpq2kjsQjG/frsLln7qLSQ1APGZL1w0KpjK90+MMpI51nNHFCBw==","signatures":[{"sig":"MEQCIEW6EhZtMinH/DXzHqw05CAko/oOavoomVUWkFMvy1NnAiAGKmyIHInBtmYeJP1K80/qb61oeX1P4vTsRLa6VxkARg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":226621},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"e6e01ce1cb1f30c655fc867415985d1a41b439f8","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/internet-archive-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/internet-archive-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-GPIgsFeiClnFsMDC8SZeWZOe35GOo2pGzRnDpq2kjsQjG/frsLln7qLSQ1APGZL1w0KpjK90+MMpI51nNHFCBw==","repository":{"url":"git+https://github.com/cyanheads/internet-archive-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text 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.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/internet-archive-mcp-server_0.1.2_1780813951219_0.26546754558324714","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@cyanheads/internet-archive-mcp-server","version":"0.1.3","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","internet-archive","wayback-machine","wayback","cdx","archive","web-archive","historical-data"],"author":"cyanheads (https://github.com/cyanheads/internet-archive-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/internet-archive-mcp-server@0.1.3","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/internet-archive-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/internet-archive-mcp-server/issues"},"bin":{"internet-archive-mcp-server":"dist/index.js"},"dist":{"shasum":"9c865e1212ccc20106e862b9ea87f3adea5ef9f5","tarball":"https://registry.npmjs.org/@cyanheads/internet-archive-mcp-server/-/internet-archive-mcp-server-0.1.3.tgz","fileCount":79,"integrity":"sha512-TAVoAFFsXDrf1mAmnnI7igCKSh2CnOsBb/9M5mWz8pP/P2PMe7AVFjF7dsgMpyYyeZ5dWCvkYFT+xtWhmRyiaw==","signatures":[{"sig":"MEUCIQCZ4hF48LOzhzyswFOOzUFODGYN5AbeFFYZjMQ2lT/ZDgIgRGJKwMEy+Jf/vVsUrWeKx6XIwWleZIvCmTmNFw7B4bM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":232253},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"9c865e1212ccc20106e862b9ea87f3adea5ef9f5","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/internet-archive-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/internet-archive-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/internet-archive-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-TAVoAFFsXDrf1mAmnnI7igCKSh2CnOsBb/9M5mWz8pP/P2PMe7AVFjF7dsgMpyYyeZ5dWCvkYFT+xtWhmRyiaw==","repository":{"url":"git+https://github.com/cyanheads/internet-archive-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text 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/internet-archive-mcp-server_0.1.3_1781322642291_0.034438202364931225","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@cyanheads/internet-archive-mcp-server","version":"0.1.4","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","internet-archive","wayback-machine","wayback","cdx","archive","web-archive","historical-data"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/internet-archive-mcp-server@0.1.4","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/internet-archive-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/internet-archive-mcp-server/issues"},"bin":{"internet-archive-mcp-server":"dist/index.js"},"dist":{"shasum":"a60e3486902b5034f8123cd3c92816c41fe81986","tarball":"https://registry.npmjs.org/@cyanheads/internet-archive-mcp-server/-/internet-archive-mcp-server-0.1.4.tgz","fileCount":80,"integrity":"sha512-TrA/5TJ2Mlb+y5jlE/eOlu+XPygaXhyqBYNQ5kS7ZaCOzjbgSLWxIUoxbf86f5pTRft7tDV6rWBwqtFZf9S+zQ==","signatures":[{"sig":"MEUCIEK7pnUsWys4U6db1hXEslKN/eSdRcVO1saepy+vYwYQAiEAjc+AqzT5jpiH4GUd2EaABI2EfTeCageQOKVocUajQqU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":240914},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"a60e3486902b5034f8123cd3c92816c41fe81986","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/internet-archive-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/internet-archive-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/internet-archive-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-TrA/5TJ2Mlb+y5jlE/eOlu+XPygaXhyqBYNQ5kS7ZaCOzjbgSLWxIUoxbf86f5pTRft7tDV6rWBwqtFZf9S+zQ==","repository":{"url":"git+https://github.com/cyanheads/internet-archive-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text 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","fast-check":"^4.9.0","typescript":"^7.0.2","@types/node":"^26.2.0","@biomejs/biome":"^2.5.9","@vitest/coverage-istanbul":"^4.1.11","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/internet-archive-mcp-server_0.1.4_1787328425354_0.903251954675012","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@cyanheads/internet-archive-mcp-server","version":"0.1.5","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","internet-archive","wayback-machine","wayback","cdx","archive","web-archive","historical-data"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/internet-archive-mcp-server@0.1.5","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/internet-archive-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/internet-archive-mcp-server/issues"},"bin":{"internet-archive-mcp-server":"dist/index.js"},"dist":{"shasum":"c6db34c229cec659927b833cec2c73e4792ccd00","tarball":"https://registry.npmjs.org/@cyanheads/internet-archive-mcp-server/-/internet-archive-mcp-server-0.1.5.tgz","fileCount":81,"integrity":"sha512-20cGtnASEn0NPjZWa62bNcxlsZlRyOaQHfXGw6Hv7Z/Yc9qOCXCzEfbDEc+WWVLGCmXnPCPjPEd54JAQlCCvaw==","signatures":[{"sig":"MEUCIBoK9ttcpAGfy6irq1hFHJxP6G6wAnstcFgyVhCP0Sz2AiEA5Sin8OjsKfCbj03tpPox6nMzVZN6rOJ0cWvJLAIQJUQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCgbsQXzDOOvu8GzHucu9V7iFYXjJPYdF8GzAs7olEZaAIhAKdQNAw1rQUmWzKe073WXbu1SsIlxoqI+ZzijAz8bN5L","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":259461},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"c6db34c229cec659927b833cec2c73e4792ccd00","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/internet-archive-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/internet-archive-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/internet-archive-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-20cGtnASEn0NPjZWa62bNcxlsZlRyOaQHfXGw6Hv7Z/Yc9qOCXCzEfbDEc+WWVLGCmXnPCPjPEd54JAQlCCvaw==","repository":{"url":"git+https://github.com/cyanheads/internet-archive-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text 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","fast-check":"^4.10.1","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/internet-archive-mcp-server_0.1.5_1789835374140_0.0395194138820143","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@cyanheads/internet-archive-mcp-server","version":"0.2.0","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","internet-archive","wayback-machine","wayback","cdx","archive","web-archive","historical-data"],"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/internet-archive-mcp-server@0.2.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/internet-archive-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/internet-archive-mcp-server/issues"},"bin":{"internet-archive-mcp-server":"dist/index.js"},"dist":{"shasum":"36db8ebc6b5123ed7606aafb3d6ccfe87185722f","tarball":"https://registry.npmjs.org/@cyanheads/internet-archive-mcp-server/-/internet-archive-mcp-server-0.2.0.tgz","fileCount":82,"integrity":"sha512-NdNTEWf6myP5FPt2e7zPqQwbpnT71kpkn1s3XmpDA2OEIEL9IpzlGjx3MCZXnHAZtCqI2Z2BtuG9Ni5seeSy7A==","signatures":[{"sig":"MEUCIQCdx7G7g8pQStSj0fdmnN7UauFjT10sdeKIdKsvPBZ/XgIgQZIoh0L9imkIVcCWN3IRRT7xMxfv21tpELmiXlBEOsk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCCjLDT4PTtCZOABzTb0OyQ+dtyzXjfB3zw9E88+PqwewIgeia8SDqraIpvfkeUuB0IQyJ4bVQZpZeKKGz1SF/bxko=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":272092},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"36db8ebc6b5123ed7606aafb3d6ccfe87185722f","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/internet-archive-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/internet-archive-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/internet-archive-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-NdNTEWf6myP5FPt2e7zPqQwbpnT71kpkn1s3XmpDA2OEIEL9IpzlGjx3MCZXnHAZtCqI2Z2BtuG9Ni5seeSy7A==","repository":{"url":"git+https://github.com/cyanheads/internet-archive-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text 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","fast-check":"^4.10.2","typescript":"^7.0.2","@types/node":"^26.6.2","@biomejs/biome":"^2.5.14","@vitest/coverage-istanbul":"^5.0.1","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/internet-archive-mcp-server_0.2.0_1790268611511_0.367619492657145","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"_id":"@cyanheads/internet-archive-mcp-server@0.3.0","bin":{"internet-archive-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/internet-archive-mcp-server/issues"},"dist":{"shasum":"e3939bafd31d7e127b71b81d188d84246b1c9bff","tarball":"https://registry.npmjs.org/@cyanheads/internet-archive-mcp-server/-/internet-archive-mcp-server-0.3.0.tgz","fileCount":95,"integrity":"sha512-iToMXYvG8F44wjX7+fY6VrNdeySnZVzrdXTIzwDwJaxln67XO2dZmTME1/E4kM5pp1thQcdgwhGwMbtRufYLdA==","signatures":[{"sig":"MEUCIQCqL7P2NZh3JeqWMOBsMoL2ZYUP5GQ6r98lKz9sTje7FQIgWsxB+EP078ADffl8ttbJDRTzs4vsZUvsf2V7PpqYx10=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHp1QV53yIoQOamU+BEooiliH/EVl4Vmgxz0g0T+DXkHAiEA9vJgK2sH7gIqTe+xUXpqIz0h74qgB2amUhMeYxb/ouA="}],"unpackedSize":332842},"main":"dist/index.js","name":"@cyanheads/internet-archive-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand (https://caseyjhand.com)","shasum":"e3939bafd31d7e127b71b81d188d84246b1c9bff","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/internet-archive-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/internet-archive-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/internet-archive-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.3.0","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/internet-archive-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","internet-archive","wayback-machine","wayback","cdx","archive","web-archive","historical-data"],"_integrity":"sha512-iToMXYvG8F44wjX7+fY6VrNdeySnZVzrdXTIzwDwJaxln67XO2dZmTME1/E4kM5pp1thQcdgwhGwMbtRufYLdA==","repository":{"url":"git+https://github.com/cyanheads/internet-archive-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text 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","@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","fast-check":"^4.10.2","typescript":"^7.0.2","@types/node":"^26.6.2","@biomejs/biome":"^2.5.14","@vitest/coverage-istanbul":"^5.0.1","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/internet-archive-mcp-server_0.3.0_1790279321700_0.5658000930378031"}}},"time":{"created":"2026-06-05T12:13:17.806Z","modified":"2026-09-24T19:48:41.992Z","0.1.1":"2026-06-05T12:13:18.192Z","0.1.2":"2026-06-07T06:32:31.395Z","0.1.3":"2026-06-13T03:50:42.440Z","0.1.4":"2026-08-21T16:07:05.485Z","0.1.5":"2026-09-19T16:29:34.262Z","0.2.0":"2026-09-24T16:50:11.620Z","0.3.0":"2026-09-24T19:48:41.806Z"},"bugs":{"url":"https://github.com/cyanheads/internet-archive-mcp-server/issues"},"author":"Casey Hand (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/internet-archive-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","ai-agent","internet-archive","wayback-machine","wayback","cdx","archive","web-archive","historical-data"],"repository":{"url":"git+https://github.com/cyanheads/internet-archive-mcp-server.git","type":"git"},"description":"Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text via MCP. STDIO or Streamable HTTP.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"
\n

@cyanheads/internet-archive-mcp-server

\n

Search the Wayback Machine and IA library (40M+ items), fetch archived snapshots, retrieve item metadata and full text via MCP. STDIO or Streamable HTTP.\n

5 Tools • 1 Resource
\n

\n
\n\n
\n\n[![Version](https://img.shields.io/badge/Version-0.3.0-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/internet-archive-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.0.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/internet-archive-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/internet-archive-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^7.0.2-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.4.0%2B-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/internet-archive-mcp-server/releases/latest/download/internet-archive-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=internet-archive-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvaW50ZXJuZXQtYXJjaGl2ZS1tY3Atc2VydmVyIl19) [![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%22internet-archive-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Finternet-archive-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\nThe Wayback Machine and Internet Archive library (40M+ items). Find and fetch archived snapshots of any URL, search the library by keyword and metadata, and retrieve item metadata, file manifests, and OCR text from any MCP client. Runs as a stdio process or a local Streamable HTTP server.\n\n### Tools\n\n| Tool | Description |\n|:---|:---|\n| `ia_find_snapshots` | Find Wayback Machine snapshots of a URL, by closest timestamp or full capture history |\n| `ia_get_snapshot` | Fetch archived page content at a specific Wayback timestamp |\n| `ia_search_items` | Search the IA library (40M+ items) by keyword and metadata filters |\n| `ia_get_item` | Retrieve full metadata and file manifest for an Archive item |\n| `ia_get_text` | Retrieve readable OCR text from a text item, with paging |\n\n### Resources\n\n| Resource | Description |\n|:---|:---|\n| `ia://item/{identifier}` | Metadata snapshot for an Archive item — title, creator, mediatype, description, subjects, collections, date, license, and file count |\n\nAll resource data is also reachable via `ia_get_item`.\n\n## Capability reference\n\n### `ia_find_snapshots` tool\n\n- `closest` mode: returns the nearest capture to a given `timestamp` via the Availability API, falling back to one CDX closest-capture query (preferring a `200` capture, 25 s deadline) when the Availability API has no answer\n- `history` mode: full capture list via the CDX API; filter by date range (`from`/`to`), HTTP status (`status_filter`), and MIME type\n- Default `collapse` of `timestamp:8` (one capture per day); adjustable to `timestamp:N`, N=1–14\n- Up to 10,000 records per call (`limit`, default 100); `resume_key` pagination for large histories\n- Replay URLs are always `https://web.archive.org/web/…`\n- Typed errors: `missing_timestamp` (closest mode without a `timestamp`, answered before any lookup), `no_snapshots` (no matches), `no_snapshot_available` (closest mode, no capture near timestamp from either source), `cdx_unavailable` (CDX 5xx, 429, or unreadable response, or the closest-mode CDX check did not complete), `availability_unavailable` (closest mode, Availability API 5xx, 429, or unreadable response); a 429 is answered after one request with a hint to wait\n\n---\n\n### `ia_get_snapshot` tool\n\n- Resolves to the nearest available capture when the exact timestamp has no snapshot; exact 14-digit timestamps skip resolution\n- Reports the capture Wayback served — `replay_url`, `resolved_timestamp`, and `resolved_status` follow Wayback's redirect when the requested timestamp is not itself a capture\n- Decodes the page with its declared charset (`Content-Type`, then ``, else UTF-8 when the bytes are valid UTF-8, else Wayback's guessed charset or windows-1252), then removes scripts, styles, comments, and tags and decodes character references, returning readable plain text alongside the replay URL\n- Reads at most the first 4 MiB of a page (a `notice` says when a page is longer); output capped at `IA_MAX_SNAPSHOT_CHARS` (default 50,000 characters)\n- Typed errors: `no_snapshot_available`, `content_fetch_failed` (Wayback unreachable during lookup or fetch)\n\n---\n\n### `ia_search_items` tool\n\n- Solr query syntax plus structured filters: `mediatype`, `collection`, `creator`, `language`, and date range (`date_from`/`date_to`)\n- `mediatype` takes the ten Internet Archive media types — `texts`, `movies`, `audio`, `software`, `image`, `data`, `web`, `collection`, `etree`, `account` — case-insensitively, and resolves common near-misses (`text`, `book`, `books` → `texts`; `movie`, `video`, `videos` → `movies`; `images` → `image`; `collections` → `collection`)\n- Sort by relevance, date, or downloads (`sort`, Solr syntax; default `downloads desc`)\n- Up to 200 results per page (`rows`, default 50), 1-indexed `page`\n- Output carries `total_found`, `page`, `rows` for pagination; an empty page returns a `notice` rather than an error — naming the `mediatype` applied when nothing matched, or the last page when `page` is past the end\n- Typed error `invalid_mediatype` for any other `mediatype`, listing the accepted values, answered before any search request\n\n---\n\n### `ia_get_item` tool\n\n- Returns `title`, `creator`, `description`, `subject`, `collection`, `licenseurl`, `rights`, and `language` when present in upstream metadata; `creator`, `description`, `subject`, `collection`, and `language` may be a string or a list\n- `files[]` is one page of the manifest in upstream order — `format`, `size`, `md5`, and a direct `download_url` per file; `file_count` is always the full manifest size\n- `max_files` (1–500, default 50) and `file_offset` (default 0) page through large items; when files remain, the response sets `truncated` and names the next `file_offset`\n- `format` keeps one file type (exact match, case-insensitive — e.g. `DjVuTXT`, `Text PDF`, `VBR MP3`) before paging and reports the match count as `totalCount`; a format with no matches returns an empty page and a notice listing the formats the item has\n- Typed error `item_not_found` for unknown identifiers\n\n---\n\n### `ia_get_text` tool\n\n- `max_chars` (defaults to `IA_MAX_SNAPSHOT_CHARS`) and `char_offset` page through long documents; `has_more` signals additional text remains\n- Locates the best available text file — DjVuTXT preferred, falls back to plain text; `source_file` names the file fetched\n- Typed errors: `item_not_found`, `no_text_file`, `download_forbidden` (restricted collections)\n\n---\n\n### `ia://item/{identifier}` resource\n\n- Returns `application/json` — `title`, `creator`, `mediatype`, `description`, `subject`, `collection`, `date`, `licenseurl`, `rights`, `language`, and `file_count`\n- `identifier` comes from `ia_search_items` results\n- Typed error `item_not_found` for unknown identifiers\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\nInternet Archive-specific:\n\n- No credentials required — all four APIs are public\n- Three service layers: `WaybackService` (Availability + CDX), `ArchiveSearchService` (Solr), `ArchiveMetadataService` (Metadata + downloads)\n- CDX collapse-by-day default and configurable `limit` keep responses tractable for high-capture URLs\n- Identifies via a custom User-Agent on every request as required by IA's terms of use; configurable via `IA_USER_AGENT`\n\nAgent-friendly output:\n\n- Pagination context on every list response — `total_found`, `page`, `rows` (search), `resume_key` (CDX history), and `file_count` plus the next `file_offset` (item files) so agents never have to guess whether results are complete\n- Typed error reasons (`missing_timestamp`, `no_snapshots`, `no_snapshot_available`, `cdx_unavailable`, `availability_unavailable`, `content_fetch_failed`, `invalid_mediatype`, `item_not_found`, `no_text_file`, `download_forbidden`) with recovery hints so callers can retry or explain to users without parsing text\n- Structured file manifests — `ia_get_item` returns file-level metadata (format, size, URL) and a `format` filter, so agents can pick the right file without paging through thumbnails\n\n## Getting started\n\nNo API key required — the Internet Archive's APIs are fully public.\n\nAdd the following to your MCP client configuration file:\n\n```json\n{\n \"mcpServers\": {\n \"internet-archive-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"bunx\",\n \"args\": [\"@cyanheads/internet-archive-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 \"internet-archive-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@cyanheads/internet-archive-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 \"internet-archive-mcp-server\": {\n \"type\": \"stdio\",\n \"command\": \"docker\",\n \"args\": [\n \"run\", \"-i\", \"--rm\",\n \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n \"ghcr.io/cyanheads/internet-archive-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 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 external accounts or API keys required.\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/internet-archive-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd internet-archive-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# Optional: edit .env for custom User-Agent, timeouts, etc.\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| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http` | `stdio` |\n| `MCP_HTTP_PORT` | HTTP server port | `3010` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth` | `none` |\n| `MCP_LOG_LEVEL` | Log level (`debug`, `info`, `notice`, `warning`, `error`) | `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 | `false` |\n| `IA_USER_AGENT` | Custom User-Agent for IA API requests | `internet-archive-mcp-server/{version} (github.com/cyanheads/internet-archive-mcp-server)` |\n| `IA_REQUEST_TIMEOUT_MS` | HTTP request timeout in milliseconds | `30000` |\n| `IA_MAX_SNAPSHOT_CHARS` | Default character cap for `ia_get_text` responses | `50000` |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides.\n\n## Running the server\n\n### Local development\n\n- **Build and run:**\n\n ```sh\n # One-time build\n bun run rebuild\n\n # Run the built server\n bun run start:stdio\n # or\n bun run start:http\n ```\n\n- **Run checks and tests:**\n\n ```sh\n bun run devcheck # Lint, format, typecheck, security\n bun run test # Vitest test suite\n bun run lint:mcp # Validate MCP definitions against spec\n ```\n\n### Docker\n\n```sh\ndocker build -t internet-archive-mcp-server .\ndocker run --rm -p 3010:3010 internet-archive-mcp-server\n```\n\nThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/internet-archive-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, resource, and inits services. |\n| `src/config` | Server-specific environment variable parsing and validation with Zod. |\n| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). Five tools across Wayback and IA library. |\n| `src/mcp-server/resources` | Resource definitions. `ia://item/{identifier}` item metadata resource. |\n| `src/services/wayback` | `WaybackService` — Availability API + CDX API client, plus archived-page charset decoding and text extraction. |\n| `src/services/archive-search` | `ArchiveSearchService` — Solr Advanced Search client. |\n| `src/services/archive-metadata` | `ArchiveMetadataService` — Metadata API + file download client. |\n| `tests/` | Unit and integration tests mirroring `src/`. |\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\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"}