{"_id":"@cyanheads/docgen-mcp-server","_rev":"7-6508c4b1f6585d548e652b961b756d5f","name":"@cyanheads/docgen-mcp-server","dist-tags":{"latest":"0.4.0"},"versions":{"0.2.0":{"name":"@cyanheads/docgen-mcp-server","version":"0.2.0","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","pdf","xlsx","spreadsheet","pdf-form","document-generation"],"author":"cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/docgen-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/docgen-mcp-server@0.2.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/docgen-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/docgen-mcp-server/issues"},"bin":{"docgen-mcp-server":"dist/index.js"},"dist":{"shasum":"7bc4ed2aac00fff9b328212a53d6a39df9daa043","tarball":"https://registry.npmjs.org/@cyanheads/docgen-mcp-server/-/docgen-mcp-server-0.2.0.tgz","fileCount":66,"integrity":"sha512-cCW64+VGoy1GE5G0hBa80d1yw4i7IlbSh7K5gR19zAzwWltatST6eBZiHxnheLfKCQDeKu67yjkipJGDm6oJbQ==","signatures":[{"sig":"MEUCICmO1UuuteIhiLzaRjzY7le7nWDPdIMgpT8UM7+IQCZjAiEAqgJ31MiQoO5eK/mom7bE+qi9aNMHeC9acLT74LMPKWg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":288623},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"7bc4ed2aac00fff9b328212a53d6a39df9daa043","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/docgen-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/docgen-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/docgen-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-cCW64+VGoy1GE5G0hBa80d1yw4i7IlbSh7K5gR19zAzwWltatST6eBZiHxnheLfKCQDeKu67yjkipJGDm6oJbQ==","repository":{"url":"git+https://github.com/cyanheads/docgen-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","marked":"^18.0.5","exceljs":"^4.4.0","pdf-lib":"^1.17.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.9"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"^26.0.1","@biomejs/biome":"^2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/docgen-mcp-server_0.2.0_1782623002381_0.40873067570149857","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@cyanheads/docgen-mcp-server","version":"0.2.1","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","pdf","xlsx","spreadsheet","pdf-form","document-generation"],"author":"cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/docgen-mcp-server#readme)","license":"Apache-2.0","_id":"@cyanheads/docgen-mcp-server@0.2.1","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/docgen-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/docgen-mcp-server/issues"},"bin":{"docgen-mcp-server":"dist/index.js"},"dist":{"shasum":"77ad6baf90cec1ec7b40de4bfe101322cd521019","tarball":"https://registry.npmjs.org/@cyanheads/docgen-mcp-server/-/docgen-mcp-server-0.2.1.tgz","fileCount":67,"integrity":"sha512-pOrJxuomk2ua9t9I9RjkBd2R33Ctmt00DHU/45EAmlmV3hDUai3p1a0R1v788aRXzrz9ytJ1sLoW9pf/H73DdQ==","signatures":[{"sig":"MEUCIQDxwTNEL7fCc7uMfCLoWQ80MXZ80g/YPqKnFBqlRDlzIQIgBFkPIqBVhWgmVjXvVxpmd4X15W7Aa7y4L1wHX79U6gU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":296575},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"77ad6baf90cec1ec7b40de4bfe101322cd521019","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/docgen-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/docgen-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/docgen-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-pOrJxuomk2ua9t9I9RjkBd2R33Ctmt00DHU/45EAmlmV3hDUai3p1a0R1v788aRXzrz9ytJ1sLoW9pf/H73DdQ==","repository":{"url":"git+https://github.com/cyanheads/docgen-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"24.3.0","dependencies":{"zod":"^4.4.3","marked":"^18.0.5","exceljs":"^4.4.0","pdf-lib":"^1.17.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.10.9"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.3.2","devDependencies":{"ignore":"^7.0.5","vitest":"^4.1.8","depcheck":"^1.4.7","tsc-alias":"^1.8.17","typescript":"^6.0.3","@types/node":"^26.0.1","@biomejs/biome":"^2.5.1"},"_npmOperationalInternal":{"tmp":"tmp/docgen-mcp-server_0.2.1_1782654350153_0.612594799507356","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@cyanheads/docgen-mcp-server","version":"0.2.2","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","pdf","xlsx","spreadsheet","pdf-form","document-generation"],"author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/docgen-mcp-server@0.2.2","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/docgen-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/docgen-mcp-server/issues"},"bin":{"docgen-mcp-server":"dist/index.js"},"dist":{"shasum":"4269766e4966f315d78da588fe1ccc525744be80","tarball":"https://registry.npmjs.org/@cyanheads/docgen-mcp-server/-/docgen-mcp-server-0.2.2.tgz","fileCount":68,"integrity":"sha512-3U7b78dEFF38CRDh6m3zk+oUdApVXW8ebQx6OX/fZw8tN4FnnzBu9YlxBIl8RaGYnL67Hb4R9Yb2DCb58UhFoA==","signatures":[{"sig":"MEYCIQD+bBy7GHdtf01EoFFbSpKR7Tp9Z4790x6/OEmxJd699QIhALeiRy/IFrRbvUhU3opjlixUVmSLrwLIMpnuDGjGMzZF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":303915},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"4269766e4966f315d78da588fe1ccc525744be80","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/docgen-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/docgen-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/docgen-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-3U7b78dEFF38CRDh6m3zk+oUdApVXW8ebQx6OX/fZw8tN4FnnzBu9YlxBIl8RaGYnL67Hb4R9Yb2DCb58UhFoA==","repository":{"url":"git+https://github.com/cyanheads/docgen-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.4.3","marked":"^18.0.10","exceljs":"^4.4.0","pdf-lib":"^1.17.1","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/docgen-mcp-server_0.2.2_1787354552713_0.6508003491884358","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@cyanheads/docgen-mcp-server","version":"0.2.3","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","pdf","xlsx","spreadsheet","pdf-form","document-generation"],"author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/docgen-mcp-server@0.2.3","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/docgen-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/docgen-mcp-server/issues"},"bin":{"docgen-mcp-server":"dist/index.js"},"dist":{"shasum":"89acbe6932b955508db8d3049cfbfdcbbe881aab","tarball":"https://registry.npmjs.org/@cyanheads/docgen-mcp-server/-/docgen-mcp-server-0.2.3.tgz","fileCount":69,"integrity":"sha512-qJ+oYHQ6PlTeprbuPcuNOkE5YqClThwQ1kDP5dqmkeboDsrmUNeBREoCZ5YFYKYQpu876XHXv2K/wU/nfeM4dQ==","signatures":[{"sig":"MEYCIQCZvFtvwzmPnQlJzXHyY7DLa5teJp+8pd4c/QJ1ZeL3IQIhAJcAH2GeHetng2Iu7Ah2ela96BFVhdb8/aaWYfKpEsav","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDosUfIFNwSqVRRtzq4sk7/9fg+uayE/6gbc70Qjs4U+AIhALuyKavrFN6mL55KgFePNwPeaMMVbtutrb0nneA+Nab7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":320606},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"89acbe6932b955508db8d3049cfbfdcbbe881aab","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/docgen-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/docgen-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/docgen-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-qJ+oYHQ6PlTeprbuPcuNOkE5YqClThwQ1kDP5dqmkeboDsrmUNeBREoCZ5YFYKYQpu876XHXv2K/wU/nfeM4dQ==","repository":{"url":"git+https://github.com/cyanheads/docgen-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","marked":"^18.0.13","exceljs":"^4.4.0","pdf-lib":"^1.17.1","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.2","@biomejs/biome":"^2.5.14","@vitest/coverage-istanbul":"^5.0.1","@socketsecurity/bun-security-scanner":"^1.1.2"},"_npmOperationalInternal":{"tmp":"tmp/docgen-mcp-server_0.2.3_1790050869036_0.06106603506741415","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@cyanheads/docgen-mcp-server","version":"0.2.4","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","pdf","xlsx","spreadsheet","pdf-form","document-generation"],"author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/docgen-mcp-server@0.2.4","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/docgen-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/docgen-mcp-server/issues"},"bin":{"docgen-mcp-server":"dist/index.js"},"dist":{"shasum":"9db38835c54820437525e12498047527d712607e","tarball":"https://registry.npmjs.org/@cyanheads/docgen-mcp-server/-/docgen-mcp-server-0.2.4.tgz","fileCount":70,"integrity":"sha512-WgrHNGmFvDbjD6muO7EYDiqzS9cF2YBZJvbsnbskUzxfDEXpD1ASXKg0WbbQ0nWqbElg0aWNSHfUKurXM8YHHw==","signatures":[{"sig":"MEUCIA30e30g4qu/f7zPgw/bRE63rCYd9o/49Rohgjxt9srHAiEAtYo5D83O0k4AP1t3YiDSiuHC0VPdcSLUZw4VgSURJH8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIB8U/l6Z8sXysQmEmtj74A9U3LM5G7Oswi+LK22WO1h9AiBirxWRLzbbuEjk4fUeUgu35bO2BOM9dDwb0SpfheQ5Sw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":320899},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"9db38835c54820437525e12498047527d712607e","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/docgen-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/docgen-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/docgen-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-WgrHNGmFvDbjD6muO7EYDiqzS9cF2YBZJvbsnbskUzxfDEXpD1ASXKg0WbbQ0nWqbElg0aWNSHfUKurXM8YHHw==","repository":{"url":"git+https://github.com/cyanheads/docgen-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","marked":"^18.0.14","exceljs":"^4.4.0","pdf-lib":"^1.17.1","pino-pretty":"^13.1.3","@cyanheads/mcp-ts-core":"^0.13.13"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.2","devDependencies":{"ignore":"^7.0.12","vitest":"^5.0.3","depcheck":"^1.4.7","tsc-alias":"^1.9.7","fast-check":"^4.10.2","typescript":"^7.0.2","@types/node":"^26.6.4","@biomejs/biome":"^2.5.15","@vitest/coverage-istanbul":"^5.0.3","@socketsecurity/bun-security-scanner":"^1.1.3"},"_npmOperationalInternal":{"tmp":"tmp/docgen-mcp-server_0.2.4_1791373463900_0.7120563064976624","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@cyanheads/docgen-mcp-server","version":"0.3.0","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","pdf","xlsx","spreadsheet","pdf-form","document-generation"],"author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","license":"Apache-2.0","_id":"@cyanheads/docgen-mcp-server@0.3.0","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"homepage":"https://github.com/cyanheads/docgen-mcp-server#readme","bugs":{"url":"https://github.com/cyanheads/docgen-mcp-server/issues"},"bin":{"docgen-mcp-server":"dist/index.js"},"dist":{"shasum":"9dd5d5c4837151302c0e930030d0dde8b35072d4","tarball":"https://registry.npmjs.org/@cyanheads/docgen-mcp-server/-/docgen-mcp-server-0.3.0.tgz","fileCount":79,"integrity":"sha512-wrc1TKJd6Vi21uhT31DXTIA/vJ+m6W6Xp78GieEtPHYtXfxBlsekIMvYzj7LNhZCGyzgazKLbRFHRIb4l08c3Q==","signatures":[{"sig":"MEUCIQDQ95Vx2IpZRu3ZbIVvtaIWUi/11bzF+xBgtDDblDl4XwIgbguxGbBFaE2Kk2bs7SFqUYL0YEW67dHgFDbCb8bvO2c=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCICd0tOVuMXJt6fu5xetiM1U5XcO30MjILvdUk+5EQuiPAiEAlZgCounUfSkrjz1CDgIf616wsn69DQwrNXTveumnyxM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":347803},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","shasum":"9dd5d5c4837151302c0e930030d0dde8b35072d4","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/docgen-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/docgen-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/docgen-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-wrc1TKJd6Vi21uhT31DXTIA/vJ+m6W6Xp78GieEtPHYtXfxBlsekIMvYzj7LNhZCGyzgazKLbRFHRIb4l08c3Q==","repository":{"url":"git+https://github.com/cyanheads/docgen-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.","directories":{},"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.5","marked":"^18.1.0","exceljs":"^4.4.0","pdf-lib":"^1.17.1","pino-pretty":"^13.2.0","@cyanheads/mcp-ts-core":"^0.13.15"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.3","devDependencies":{"ignore":"^7.0.12","vitest":"^5.0.3","depcheck":"^1.4.7","tsc-alias":"^1.9.7","fast-check":"^4.10.2","typescript":"^7.0.2","@types/node":"^26.6.5","@biomejs/biome":"^2.5.15","@vitest/coverage-istanbul":"^5.0.3","@socketsecurity/bun-security-scanner":"^1.1.3"},"_npmOperationalInternal":{"tmp":"tmp/docgen-mcp-server_0.3.0_1791901555105_0.31649421095179053","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"_id":"@cyanheads/docgen-mcp-server@0.4.0","bin":{"docgen-mcp-server":"dist/index.js"},"bugs":{"url":"https://github.com/cyanheads/docgen-mcp-server/issues"},"dist":{"shasum":"c59e1298b86811cdaff38537ba7399020b932656","tarball":"https://registry.npmjs.org/@cyanheads/docgen-mcp-server/-/docgen-mcp-server-0.4.0.tgz","fileCount":89,"integrity":"sha512-xltcVZ2581kx/xtzxz8pJ+orbNa2n7l1aNkCKzq92RNudLlj+aF2rLYjnf5ML5w4iW52aoQRr8UlRrG8Tg1KnA==","signatures":[{"sig":"MEUCIDx9UFLtART12DFW2E8auQEQ4g6Uhxu6yxg/RHgky/JVAiEA46o1wV9ktMyhnfIiwdeX7vcSMZaze6wBeg4ZYLFiFus=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIFcuUWHILmCZtYhD5EZG91iCZ7L0Q1PMmIBw5fiy+sK7AiEAryF8P2KMrb/nCPjhoE8a/s/SGW0zzq77q2GCsNSI+q8="}],"unpackedSize":391624},"main":"dist/index.js","name":"@cyanheads/docgen-mcp-server","type":"module","types":"dist/index.d.ts","author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","shasum":"c59e1298b86811cdaff38537ba7399020b932656","engines":{"bun":">=1.4.4","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/docgen-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/docgen-mcp-server.mcpb && bun run scripts/clean-mcpb.ts dist/docgen-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.4.0","_npmUser":{"name":"cyanheads","email":"casey@caseyjhand.com"},"homepage":"https://github.com/cyanheads/docgen-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","pdf","xlsx","spreadsheet","pdf-form","document-generation"],"_integrity":"sha512-xltcVZ2581kx/xtzxz8pJ+orbNa2n7l1aNkCKzq92RNudLlj+aF2rLYjnf5ML5w4iW52aoQRr8UlRrG8Tg1KnA==","repository":{"url":"git+https://github.com/cyanheads/docgen-mcp-server.git","type":"git"},"_npmVersion":"10.8.3","description":"Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.","directories":{},"maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"_nodeVersion":"26.3.0","dependencies":{"zod":"^4.6.7","marked":"^18.2.0","exceljs":"^4.4.0","pdf-lib":"^1.17.1","pino-pretty":"^13.2.0","@cyanheads/mcp-ts-core":"^0.13.22"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"bun@1.4.4","devDependencies":{"ignore":"^7.0.14","vitest":"^5.1.0","depcheck":"^1.4.7","tsc-alias":"^1.9.10","fast-check":"^4.10.2","typescript":"^7.0.2","@types/node":"^26.6.6","@biomejs/biome":"^2.6.6","@vitest/coverage-istanbul":"^5.1.0","@socketsecurity/bun-security-scanner":"^1.1.3"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/docgen-mcp-server_0.4.0_1794388456906_0.9889228296553757"}}},"time":{"created":"2026-06-28T05:03:22.206Z","modified":"2026-11-11T09:14:17.456Z","0.2.0":"2026-06-28T05:03:22.552Z","0.2.1":"2026-06-28T13:45:50.297Z","0.2.2":"2026-08-21T23:22:32.849Z","0.2.3":"2026-09-22T04:21:09.151Z","0.2.4":"2026-10-07T11:44:24.015Z","0.3.0":"2026-10-13T14:25:55.240Z","0.4.0":"2026-11-11T09:14:17.076Z"},"bugs":{"url":"https://github.com/cyanheads/docgen-mcp-server/issues"},"author":"Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)","license":"Apache-2.0","homepage":"https://github.com/cyanheads/docgen-mcp-server#readme","keywords":["mcp","mcp-server","model-context-protocol","typescript","bun","stdio","streamable-http","pdf","xlsx","spreadsheet","pdf-form","document-generation"],"repository":{"url":"git+https://github.com/cyanheads/docgen-mcp-server.git","type":"git"},"description":"Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.","maintainers":[{"name":"cyanheads","email":"casey@caseyjhand.com"}],"readme":"<div align=\"center\">\n  <h1>@cyanheads/docgen-mcp-server</h1>\n  <p><b>Render HTML/markdown to PDF, export rows to xlsx, and fill AcroForm PDFs via MCP. STDIO or Streamable HTTP.</b>\n  <div>5 Tools • 1 Document Resource • 1 Skill</div>\n  </p>\n</div>\n\n<div align=\"center\">\n\n[![Version](https://img.shields.io/badge/Version-0.4.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/docgen-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^2.4.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/@cyanheads/docgen-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/docgen-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.4-blueviolet.svg?style=flat-square)](https://bun.sh/)\n\n</div>\n\n<div align=\"center\">\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/docgen-mcp-server/releases/latest/download/docgen-mcp-server.mcpb) [![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=docgen-mcp-server&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBjeWFuaGVhZHMvZG9jZ2VuLW1jcC1zZXJ2ZXIiXX0=) [![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%22docgen-mcp-server%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40cyanheads%2Fdocgen-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</div>\n\n---\n\n## Overview\n\nGenerate documents from an agent: render HTML, markdown, or template data to PDF, export rows to Excel, and fill PDF forms. Everything renders locally on a bundled stack (pdf-lib, exceljs, marked).\n\n### Tools\n\n| Tool | Description |\n|:---|:---|\n| `docgen_render_pdf` | Render HTML, markdown, or a `{{key}}` template + data object to a downloadable PDF |\n| `docgen_export_spreadsheet` | Render one or more named worksheets of row objects to a downloadable `.xlsx` workbook |\n| `docgen_fill_form` | Fill the AcroForm fields of a supplied PDF (base64 or https URL) and optionally flatten it |\n| `docgen_list_form_fields` | Inspect AcroForm names, values, constraints, choice options and widget pages without changing the PDF |\n| `docgen_get_document` | Re-fetch a previously rendered document by the id a render/export/fill tool returned |\n\n### Resources\n\n| Resource | Description |\n|:---|:---|\n| `docgen://document/{documentId}` | A rendered document by id — raw bytes as a blob plus a JSON metadata block |\n\n`docgen_get_document` retrieves the delivery envelope. Read the resource for bytes when the envelope omits inline base64.\n\n### Skill\n\n[`docgen-guide`](./skills/docgen-guide/SKILL.md) walks through inspecting, filling, verifying, and flattening an AcroForm PDF. It is available to plugin hosts and MCP clients that support the Skills extension.\n\n## Capability reference\n\n### `docgen_render_pdf` <sub>tool</sub>\n\n- Provide exactly one `source`: `{ html }`, `{ markdown }`, or `{ template, data }` for `{{key}}` interpolation. `pageOptions` controls page size/orientation, CSS-length margins, headers/footers (`{{page}}`, `{{total}}`, `{{date}}`) and page numbers.\n- Returns a `DocumentEnvelope` with `pageCount`; `degraded: true` means CSS, images or scripts were dropped, or characters were replaced with `?`. The lightweight engine renders headings, paragraphs, lists and tables.\n- Typed failures: `invalid_source`, `template_render_failed`, `document_too_large`, `render_timeout`.\n\n---\n\n### `docgen_export_spreadsheet` <sub>tool</sub>\n\n- Supply at least one sheet with a unique `name` (1–31 characters) and scalar `rows[]`; empty rows yield a header-only sheet. Optional `columns[]` sets headers, type (`string` / `number` / `date` / `boolean`), width and Excel format.\n- Omitted columns use all row keys in first-seen order. Boolean columns accept `true/1/yes/on` and `false/0/no/off`, case-insensitive; other strings stay text.\n- Returns a `DocumentEnvelope` with `sheetCount`. Typed failures: `empty_workbook`, `invalid_sheet_name`, `document_too_large`, `render_timeout`.\n\n---\n\n### `docgen_fill_form` <sub>tool</sub>\n\n- Provide exactly one `sourcePdf`: `{ base64 }` or `{ url }` (public HTTPS serving `application/pdf`, or `application/octet-stream` whose bytes start with `%PDF-`), plus a `fields` map. Flat or XFA-only PDFs return `not_a_form`.\n- Inspect unfamiliar PDFs with `docgen_list_form_fields`. Exact names take precedence across the whole map; a unique last segment or case-insensitive full name also works. Ambiguous or conflicting aliases remain unmatched.\n- Returns a `DocumentEnvelope` with `pageCount`, `unmatchedFields[]`, `resolvedFields[]` for accepted aliases, and `madeEditableFields[]` for dropdowns made editable by custom text. The accompanying notices disclose custom dropdown values and unrecognized checkbox values.\n- Checkboxes accept booleans, common checked/unchecked strings and their PDF export value. Radios and option lists accept an exact option or a unique case-insensitive match. Dropdown custom text is preserved verbatim.\n- Invalid assignments are reported together as `invalid_field_value`, with field constraints and a recovery hint; no document is stored on failure.\n- `flatten: true` makes the filled values non-editable (default `false`).\n\n---\n\n### `docgen_list_form_fields` <sub>tool</sub>\n\n- Accepts the same `sourcePdf` base64-or-URL source as `docgen_fill_form`. Returns `{ fields: [{ name, type, required, options?, label?, maxLength?, onValue?, value?, page? }] }` without modifying the PDF or storing a document.\n- Types: `text`, `checkbox`, `dropdown`, `optionList`, `radioGroup`, `signature`, `button`. Only dropdown, optionList and radioGroup entries include `options`; signatures and buttons are discovery only.\n- Optional metadata reflects the PDF: tooltip, text length limit, checkbox export value, current value and the first widget's 1-based page. Missing metadata is omitted; unchecked boxes and empty selections remain `false` and `[]`. Nested names retain their exact paths. PDFs without AcroForm fields return `not_a_form`.\n\n---\n\n### `docgen_get_document` <sub>tool</sub>\n\n- Supply the `documentId` an earlier render/export/fill returned (`doc_` plus 24 url-safe characters).\n- Re-fetches its `DocumentEnvelope` without rendering again; an expired or unknown id returns `document_expired`.\n\n---\n\n### `docgen://document/{documentId}` <sub>resource</sub>\n\n- Use the `documentId` from a render/export/fill result (`doc_` plus 24 url-safe characters).\n- Returns a base64 `blob` with the document's MIME type and JSON metadata (`documentId`, `byteSize`, `pageCount`/`sheetCount`, `createdAt`, `ttlSecondsRemaining`). Reads the same store as `docgen_get_document`; expired or unknown ids return `document_expired`.\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\ndocgen-specific:\n\n- Bundled rendering stack (`pdf-lib`, `exceljs`, `marked`); only caller-supplied URL sources require a network fetch\n- One shared `DocumentEnvelope` across the four document delivery tools; field inspection returns its inventory directly\n- Bounded renders — a byte ceiling (`DOCGEN_MAX_DOCUMENT_BYTES`) and a timeout (`DOCGEN_RENDER_TIMEOUT_MS`) turn a runaway render into a typed error instead of a hang\n- Tenant-scoped, expiring storage — a document id resolves only for the tenant that created it, and documents expire rather than accumulate\n- SSRF-guarded form fetch — both form tools check every address, including each redirect hop, and block private, loopback and link-local destinations\n\nAgent-friendly output:\n\n- Dual-surface delivery — every envelope field appears in both `structuredContent` and the markdown output, including the `documentId`, resource URI, size, and TTL\n- Inline by size — `inlineBase64` is populated only at or under `DOCGEN_INLINE_MAX_BYTES`; larger documents are delivered through the resource URI\n- Fill reporting — unmatched names, resolved aliases and dropdown editability changes are visible on both output surfaces\n- Typed errors with recovery hints (`invalid_source`, `template_render_failed`, `document_too_large`, `render_timeout`, `not_a_form`, `source_unfetchable`, `document_expired`, …); semantic validation uses `ValidationError` (`-32007`) and malformed arguments `InvalidParams` (`-32602`)\n\n## Getting started\n\nAdd the following to your MCP client configuration file. No API keys are required.\n\n```json\n{\n  \"mcpServers\": {\n    \"docgen-mcp-server\": {\n      \"type\": \"stdio\",\n      \"command\": \"bunx\",\n      \"args\": [\"@cyanheads/docgen-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    \"docgen-mcp-server\": {\n      \"type\": \"stdio\",\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@cyanheads/docgen-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    \"docgen-mcp-server\": {\n      \"type\": \"stdio\",\n      \"command\": \"docker\",\n      \"args\": [\n        \"run\", \"-i\", \"--rm\",\n        \"-e\", \"MCP_TRANSPORT_TYPE=stdio\",\n        \"ghcr.io/cyanheads/docgen-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\nDocuments are delivered by the `docgen://document/{id}` resource (and inline base64 when small enough) over every transport. The envelope's `downloadUrl` field is reserved for a future HTTP download route and is not emitted in this version.\n\n### Prerequisites\n\n- [Bun v1.4.4](https://bun.sh/) or higher (or Node.js v24+). Development uses Bun v1.4.4.\n\n### Installation\n\n1. **Clone the repository:**\n\n```sh\ngit clone https://github.com/cyanheads/docgen-mcp-server.git\n```\n\n2. **Navigate into the directory:**\n\n```sh\ncd docgen-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 to override any defaults\n```\n\n## Configuration\n\nAll configuration is optional — docgen runs with no required environment variables.\n\n| Variable | Description | Default |\n|:---------|:------------|:--------|\n| `DOCGEN_DOCUMENT_TTL_SECONDS` | How long a rendered document is retrievable before it expires, in seconds. | `900` |\n| `DOCGEN_MAX_DOCUMENT_BYTES` | Hard ceiling on a single rendered artifact in bytes; exceeding it aborts the render. | `26214400` |\n| `DOCGEN_RENDER_TIMEOUT_MS` | Per-render wall-clock budget in milliseconds; exceeding it aborts the render. | `30000` |\n| `DOCGEN_INLINE_MAX_BYTES` | Artifacts at or under this byte size are returned inline as base64; larger ones omit it. | `5242880` |\n| `DOCGEN_PDF_ENGINE` | PDF rendering engine. Only `lightweight` is implemented; `chromium` is reserved and rejected at startup. | `lightweight` |\n| `MCP_TRANSPORT_TYPE` | Transport: `stdio` or `http`. | `stdio` |\n| `MCP_HTTP_PORT` | Port for the HTTP server. | `3010` |\n| `MCP_SESSION_MODE` | HTTP session mode: `auto`, `stateful`, or `stateless`. | `stateless` |\n| `MCP_AUTH_MODE` | Auth mode: `none`, `jwt`, or `oauth`. | `none` |\n| `MCP_PUBLIC_URL` | Public origin behind a TLS proxy. | — |\n| `MCP_LOG_LEVEL` | Log level (RFC 5424). | `info` |\n| `LOG_TOOL_FAILURE_PAYLOADS` | Log failed arguments/results, redacted by key name and capped by `LOG_TOOL_FAILURE_PAYLOAD_MAX_BYTES` (default `16384`). Free-form values may retain secrets. | `false` |\n| `STORAGE_PROVIDER_TYPE` | Storage backend for document bytes + metadata. | `in-memory` |\n| `OTEL_ENABLED` | Enable [OpenTelemetry instrumentation](https://github.com/cyanheads/mcp-ts-core/tree/main/docs/telemetry) (spans, metrics, completion logs). | `false` |\n| `OTEL_EXPORTER_OTLP_ENDPOINT` | Base OTLP URL; traces use `/v1/traces`, metrics use `/v1/metrics`. Signal-specific endpoints override it. | — |\n| `OTEL_EXPORTER_OTLP_LOGS_ENDPOINT` | Opt-in log endpoint, used as-is; the base URL never enables log export. | — |\n\nSee [`.env.example`](./.env.example) for the full list of optional overrides.\n\n> The default in-memory storage drops every document on restart, and earlier ids then return `document_expired`. To keep documents across restarts, point `STORAGE_PROVIDER_TYPE` at a persistent backend.\n\nWhen upgrading a filesystem store from mcp-ts-core 0.13.21 or earlier, the first start copies existing data into `_v2/` under `STORAGE_FILESYSTEM_PATH`. Allow room for both copies and upgrade every instance sharing the path before resuming writes.\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, 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 docgen-mcp-server .\ndocker run --rm -e MCP_TRANSPORT_TYPE=http -p 3010:3010 docgen-mcp-server\n```\n\nThe Dockerfile defaults to HTTP transport, stateless session mode, and logs to `/var/log/docgen-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 the tools/resource and inits the render + storage services. |\n| `src/config` | Server-specific environment variable parsing and validation with Zod. |\n| `src/mcp-server/tools` | Tool definitions (`*.tool.ts`). |\n| `src/mcp-server/resources` | Resource definitions (`*.resource.ts`). |\n| `src/services/document` | The rendering stack (`RenderService`) and artifact store (`DocumentStore`), shared types, and the SSRF fetch guard. |\n| `tests/` | Unit and integration tests mirroring `src/`. |\n\n## Development guide\n\nSee [`CLAUDE.md`/`AGENTS.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 in `src/index.ts`'s `createApp()` arrays\n- One shared `DocumentEnvelope` across all delivery tools — keep the writers and reader interchangeable\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"}