{"_id":"redact-pdf-mcp","_rev":"11-651b5c02d06e29969a3eab6a32cfadc6","name":"redact-pdf-mcp","dist-tags":{"latest":"0.5.0"},"versions":{"0.1.0":{"name":"redact-pdf-mcp","version":"0.1.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.1.0","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"7f0fa0294d547a5243ed7c6c2966dde3bd318557","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.1.0.tgz","fileCount":39,"integrity":"sha512-kiKOMqokOmi/m1rf8nTTYCyp2E9v70ls1HeRX43LvtHByuFDE2+yIGjsZuZOeKmlIlZ8e6nBcLIXD4TSavKuXQ==","signatures":[{"sig":"MEQCIEoj/kQ1ajHTOLtUfG4gWaP77Gh72QkOIUl1PAW+SM7PAiADWc5U45FaXhHGXm0Bqak5AOP8VouL5cnMwW7QIuZkfQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":225219},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"c8e68ead2194e6fa3969dd118c966a86e6129235","mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Redact PDF AI — permanently redact PII from PDFs. Give an agent a PDF, get back a redacted PDF with the sensitive text removed, not just covered.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.1.0_1788099106720_0.5015184881407047","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"redact-pdf-mcp","version":"0.1.1","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.1.1","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"725c4dc9f08cbac92f96567a8d9b23e53104d94a","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.1.1.tgz","fileCount":39,"integrity":"sha512-IxZhDtGeQbB6xept9bRhb2hM6wsV+3OxXVZ0g/KXEt7h+8Xs46JXgogzCmz2HFHjjlJQgyYe9mtC5LX6x9Y+7g==","signatures":[{"sig":"MEQCIAdCQkdk2fodb+stiyOR2B4iWTJfIwBgvyvKMp9+Wy5EAiBalxwaHI+SLTFRDpHZzg+/aIfzxJwiFWeBAnaJgMbBsQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIC+KeQSRZn92NcyFVsIFFArBneNjweDXKXEzUHUmCk3UAiA7/Vetb6sfGFzh7AXBQP3XX6fenTDd/RxpzvsOHYHymg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":234339},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"e71bb8bb8248296e06f85d356ff1a109d40709b2","mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Redact PDF AI — permanently redact PII from PDFs. Give an agent a PDF, get back a redacted PDF with the sensitive text removed, not just covered.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.1.1_1788103735012_0.4514530742927447","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"redact-pdf-mcp","version":"0.2.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.2.0","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"26478336fa3e590c7a19539dd119b7611b0c7137","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.2.0.tgz","fileCount":39,"integrity":"sha512-ys6GiUpKVmmP2LBpEtGo5lcAmDC1k2l9/5+fa87hjqOxMIt4k9twGkFCtETRsj5ib160DmGv2YVjaFIIpc4GIg==","signatures":[{"sig":"MEQCIEGsIF1kFAQ8G8Ita4eyLSXQIMFrSCFY7Ej9MQD1do6xAiADjZ+w/Ea4ap28WovybqyzhI9hrZrNAhNw8l9YeGlHgw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCNr0VfGnDGC4ia2e5dRoklSsDYkSDJeqDEgLvG+7cQ3wIhAKWTIFbeNlANnxS3fhW06CQRxXk7r/RaWnT5w9s72dzt","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":245140},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"gitHead":"7c0f10a6751e9221a42399aa1ebaf3822a427aa8","mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"MCP server for Redact PDF AI — permanently redact PII from PDFs. Give an agent a PDF, get back a redacted PDF with the sensitive text removed, not just covered.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.2.0_1789674347036_0.9599718806392286","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"redact-pdf-mcp","version":"0.2.1","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.2.1","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"b37dff1bb34847ce21ee35dd360b11d5eceecb15","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.2.1.tgz","fileCount":39,"integrity":"sha512-R852Rwf+gqnnuCgo09ClXu41ZnU55iV32bwhdM1eJb1+TnvWdkGUZqvtN+4zkolg8/ShQrcYgKoNe5HmsqIsjA==","signatures":[{"sig":"MEUCIQCskNPiwk8jw7+n8V2h0J6iBZ5CNmDLE/LKp8bR81wbDAIgODIuROnkZvr62VMwvvf40s+aZiTfi6fwwyk0FBZTzRc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIEeQFDfnhRuTcQlb3GiLafH0w8ORoGHtEsibdyDciquXAiEAtu15fUXwTtKmGutUpdaxGo7smISdJS+TZFk/qmWtyxg=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":249282},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Permanently redact PII from PDFs, scans and screenshots through your AI agent: the text is removed, not covered. EU & Swiss hosted, never used for AI training. MCP server for Redact PDF AI.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.2.1_1789707567000_0.10398086702856268","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"redact-pdf-mcp","version":"0.3.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.3.0","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"b4e985b721355e775f108dfcae895fd219421709","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.3.0.tgz","fileCount":39,"integrity":"sha512-2CJawHNanfyZSc3Q5yOXp33xxTA32rTArEGP0JrVdE9gv96wUmraDhoXeMuwPcBSJrzv79MuuB+YLILBWoprQg==","signatures":[{"sig":"MEQCIH7eEbAfjKzmZIqarCxjy/SPm/m5iq3eeXq3o9HBE1tBAiBXreyHgoqf+ZWWRVwTIXs2oicJdLsfwzvkVtWPcrvzgA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCxlQg+nE62Bnvfgq6dNecSed3HgC9mWqdE/g6kOD2ITQIgI8OydxOFzJRPhd+0+KGSRj9XEQLi7Ecd45hAsNd5yb8=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":271497},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Permanently redact PII from PDFs, scans and screenshots through your AI agent: the text is removed, not covered. EU & Swiss hosted, never used for AI training. MCP server for Redact PDF AI.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.3.0_1791834779543_0.7620793443614693","host":"s3://npm-registry-packages-npm-production"}},"0.3.1":{"name":"redact-pdf-mcp","version":"0.3.1","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance","pseudonymization","pseudonymize","anonymize-pdf"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.3.1","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"f435aa5fea710eab0f584c7c45060c8d0e928338","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.3.1.tgz","fileCount":39,"integrity":"sha512-DNMLhGE8SsmPh8tbQkGmRGoTSqYHhaqvmPFSE35h0cQNMEFZ8TU3xor4wQH49vJAr/n78C7Gh0i5wGlrR2Z37g==","signatures":[{"sig":"MEUCICcXKSpesxAJH7qT8wAoruLGBSZydUs+19OXHFwnEBVKAiEA+sJ51i9yyZ7W1TPhot66EP/jUqggs2yctyUVZ/st36w=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQCFuC92nOEN41OoRLu4cRtAsQ+WMW3QcXmX4Ir9emalFQIhAJrihzcixPBRRVG0jnrmI1yriIKnN670NWeFPhCpTR69","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":272310},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Redact or anonymize PDFs, scans and screenshots through your AI agent: black boxes, or consistent [Person 1] tags that keep the document readable. Text removed, not covered. EU & Swiss hosted, never used for AI training.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.3.1_1792315402213_0.5955936817264669","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"redact-pdf-mcp","version":"0.4.0","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance","pseudonymization","pseudonymize","anonymize-pdf"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.4.0","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"9cdc016aafc6cecf982498f2c5c9ee49562ec422","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.4.0.tgz","fileCount":42,"integrity":"sha512-5Adk/xbF/aF7ma9m5peD9w2HsYTbjd4T0ef+hqH7doRVp9g+9gR+f11G+r0Fmfg80sMELS3M5/VXswilz7C1UA==","signatures":[{"sig":"MEYCIQCc3IBaB90iQ3sVwDburPDMthKnEJWWBN9JBeP7hMQ+2QIhANZlup5Cz1hB1uaQyQS0soxXoL3vwET2tWMgmDUPAMhH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIEUpioef4WGYYoUOcehsTcgQyXCcbmwDxKPZx+FquW+JAiEAnRlXgu2EZA+QO+fkwQr/kD7LGTxFR4LIuX6XfY4Y/FQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":357941},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Redact or anonymize PDFs, scans and screenshots through your AI agent: black boxes, or consistent [Person 1] tags that keep the document readable. Text removed, not covered. EU & Swiss hosted, never used for AI training.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.4.0_1792333389930_0.32801747416202254","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"name":"redact-pdf-mcp","version":"0.4.1","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance","pseudonymization","pseudonymize","anonymize-pdf"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.4.1","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"23af18876176beef56e7dbb29a9372d03cdcd024","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.4.1.tgz","fileCount":48,"integrity":"sha512-PR0pErgBfJwacwcxBwB0cFFgR8PgerHcBjynTpAnHS+Oy18tNi3WIe7EEmrNbJxySG1JSMSP7VOJAnG1IgNC2A==","signatures":[{"sig":"MEQCIALx3Fxjz9Z4RAi74svFSiUcLQNNYLAjZdWNaNb5hD2MAiAQna9mMkZCbzOyHcnkAgsM63GpKNJVsEraKNrIyeVa/A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDnWBItivecqYjBL63c1GTIzcFVeRdL0VYd9waNEBjVTQIgD/GEfHQ7oepAQnOuSAeEYfLz9cdwJfKDigpEoY31Jys=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":412286},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Redact or anonymize PDFs, scans and screenshots through your AI agent: black boxes, or consistent [Person 1] tags that keep the document readable. Text removed, not covered. EU & Swiss hosted, never used for AI training.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.30.0"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.4.1_1792341985357_0.8368417953446943","host":"s3://npm-registry-packages-npm-production"}},"0.4.2":{"name":"redact-pdf-mcp","version":"0.4.2","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance","pseudonymization","pseudonymize","anonymize-pdf"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.4.2","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"9ee3e43fa778ab463afef54bfc04f0a41148d7b8","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.4.2.tgz","fileCount":48,"integrity":"sha512-i1vS59JWeJqyc8mQ2/CSgyhF4FiqE07eB8tPx6T+u2DcFFRohwSXrMxm4ZxNYQ2JZy8Vea9uzfGoupPATyLz9Q==","signatures":[{"sig":"MEYCIQCShid6uXmYs49/Pw8kuRkm4bH9mnNx39RpxtCbd0eKpwIhAMVF9aifXEFvl13/bYjKG099J1ZUhQRKq9qxuiW+4HCc","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIGcfj/86/Vw220rz/K12bvE9t7TDKDC5VGvQ6Oufpyd8AiA1K+x0cbFnBfw2HIKIQKS4t+D+WE9ClGixagP5n8T0WA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":412286},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Redact or anonymize PDFs, scans and screenshots through your AI agent: black boxes, or consistent [Person 1] tags that keep the document readable. Text removed, not covered. EU & Swiss hosted, never used for AI training.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.4.2_1794340202622_0.07459365117529593","host":"s3://npm-registry-packages-npm-production"}},"0.4.3":{"name":"redact-pdf-mcp","version":"0.4.3","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance","pseudonymization","pseudonymize","anonymize-pdf"],"author":{"name":"Redact PDF AI"},"license":"MIT","_id":"redact-pdf-mcp@0.4.3","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"homepage":"https://www.redact-pdf.ai/developers","bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"dist":{"shasum":"93b180a3664fbccba5da83592ea1b961511d8b42","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.4.3.tgz","fileCount":48,"integrity":"sha512-gmACIWQFY9ZoIxGFWe4L2YGfWcI4yOXzngqFiGm6HpOMpdbmdIWuz0Th0UrjuTHZaB5ZqJ6DmwOhNseTcUarkQ==","signatures":[{"sig":"MEUCIQD2FQILyxCLX2gg3WV2rT6LH2MWqvbreVes5w+6XyDUOwIgBObGCqJziUmiBEECTGjxNi153cDGaUqkHNKWXAZUrjU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIHEClIyM7SM+K3tLghJSKaJAotOZY+JSnSdtPUWo8FueAiBYxn9Z+Ksjy6Dyw2Mi3Q3rtZxWvH6pSVdAjKOb6QjJKw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":413731},"main":"dist/index.js","type":"module","types":"dist/index.d.ts","engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Redact or anonymize PDFs, scans and screenshots through your AI agent: black boxes, or consistent [Person 1] tags that keep the document readable. Text removed, not covered. EU & Swiss hosted, never used for AI training.","directories":{},"_nodeVersion":"22.22.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/redact-pdf-mcp_0.4.3_1794343311028_0.06050637353910182","host":"s3://npm-registry-packages-npm-production"}},"0.5.0":{"_id":"redact-pdf-mcp@0.5.0","bin":{"redact-pdf-mcp":"dist/stdio.js","redact-pdf-mcp-http":"dist/http.js"},"bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"dist":{"shasum":"c3fcac84ba8b0d1732edf968b9779612d4be105a","tarball":"https://registry.npmjs.org/redact-pdf-mcp/-/redact-pdf-mcp-0.5.0.tgz","fileCount":57,"integrity":"sha512-yBwi28xxGZRQqfBb20a8XFDCbGJ80uHTbHkY0KBLy0oRIHbevjOXK/oQdB3AWthKoty2isiRjFiDVvEqOKCBFg==","signatures":[{"sig":"MEQCIHVGl2Ec1H439zKEZg2kZt9ZviWc/JvqYiV6JGYYDrdVAiBrkpxmlpjnNGbbvCZjlACH5tjPJECma5hbQAY0fcnpag==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAniudgq4RcziTog6q93ySHD4H3RP+7jdNEuJkEj3Q51AiEA4B4cbNu6qB4SzwYTi+hdoXacsBKc19ZeMIj82aDJ7Nw="}],"unpackedSize":616101},"main":"dist/index.js","name":"redact-pdf-mcp","type":"module","types":"dist/index.d.ts","author":{"name":"Redact PDF AI"},"engines":{"node":">=20"},"exports":{".":{"types":"./dist/index.d.ts","default":"./dist/index.js"}},"license":"MIT","mcpName":"io.github.dambuchs/redact-pdf-mcp","scripts":{"dev":"tsc -p tsconfig.build.json --watch","test":"vitest run --exclude '**/*.integration.test.ts'","build":"tsc -p tsconfig.build.json","test:all":"vitest run","check-types":"tsc --noEmit","prepublishOnly":"npm run build","test:integration":"vitest run test/demo.integration.test.ts"},"version":"0.5.0","_npmUser":{"name":"dambuchs","email":"buchs.d@gmail.com"},"homepage":"https://www.redact-pdf.ai/developers","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance","pseudonymization","pseudonymize","anonymize-pdf"],"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"_npmVersion":"10.9.4","description":"Redact or anonymize PDFs, scans and screenshots through your AI agent: black boxes, or consistent [Person 1] tags that keep the document readable. Text removed, not covered. EU & Swiss hosted, never used for AI training.","directories":{},"maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"_nodeVersion":"22.22.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.1"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.1.11","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/redact-pdf-mcp_0.5.0_1794736525765_0.9211027456484323"}}},"time":{"created":"2026-08-30T14:11:46.624Z","modified":"2026-11-15T09:55:26.059Z","0.1.0":"2026-08-30T14:11:46.859Z","0.1.1":"2026-08-30T15:28:55.104Z","0.2.0":"2026-09-17T19:45:47.126Z","0.2.1":"2026-09-18T04:59:27.075Z","0.3.0":"2026-10-12T19:52:59.633Z","0.3.1":"2026-10-18T09:23:22.348Z","0.4.0":"2026-10-18T14:23:10.068Z","0.4.1":"2026-10-18T16:46:25.437Z","0.4.2":"2026-11-10T19:50:02.731Z","0.4.3":"2026-11-10T20:41:51.149Z","0.5.0":"2026-11-15T09:55:25.884Z"},"bugs":{"url":"https://github.com/dambuchs/redact-pdf-mcp/issues"},"author":{"name":"Redact PDF AI"},"license":"MIT","homepage":"https://www.redact-pdf.ai/developers","keywords":["mcp","modelcontextprotocol","model-context-protocol","pdf","redaction","redact","pii","gdpr","hipaa","anonymization","ocr","claude","ai-agent","mcp-server","anonymize","de-identification","document-redaction","privacy","claude-desktop","cursor","gdpr-compliance","pseudonymization","pseudonymize","anonymize-pdf"],"repository":{"url":"git+https://github.com/dambuchs/redact-pdf-mcp.git","type":"git"},"description":"Redact or anonymize PDFs, scans and screenshots through your AI agent: black boxes, or consistent [Person 1] tags that keep the document readable. Text removed, not covered. EU & Swiss hosted, never used for AI training.","maintainers":[{"name":"dambuchs","email":"buchs.d@gmail.com"}],"readme":"# Redact PDF MCP server\n\n**An MCP server that permanently redacts PII from PDFs.** Give an agent a PDF, get back a\nPDF with the sensitive text *removed from the file* — not covered with a black rectangle\nthat anyone can select, copy, or delete.\n\nMost \"redaction\" MCP servers scrub PII out of prompt text. This one takes a real document\nand returns a real redacted document.\n\n**It also anonymizes.** With `mode: \"pseudonymize\"` every person, company and address becomes a\nconsistent tag such as `[Person 1]` instead of a black box, so the document stays readable\n(e.g. before pasting a contract into ChatGPT or Claude), and you get the tag → original table to\nrestore the names.\n\n[![npm](https://img.shields.io/npm/v/redact-pdf-mcp?color=cb3837&logo=npm)](https://www.npmjs.com/package/redact-pdf-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/redact-pdf-mcp?color=cb3837)](https://www.npmjs.com/package/redact-pdf-mcp)\n[![No AI training](https://img.shields.io/badge/your%20documents-never%20used%20for%20AI%20training-2ea44f)](https://www.redact-pdf.ai/security)\n[![EU & Swiss hosted](https://img.shields.io/badge/processed%20in-EU%20%26%20Switzerland-003399)](https://www.redact-pdf.ai/security)\n[![MCP registry](https://img.shields.io/badge/MCP%20registry-io.github.dambuchs%2Fredact--pdf--mcp-blue)](https://registry.modelcontextprotocol.io)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)\n\n<a href=\"https://glama.ai/mcp/servers/dambuchs/redact-pdf-mcp\"><img width=\"380\" height=\"200\" src=\"https://glama.ai/mcp/servers/dambuchs/redact-pdf-mcp/badges/card.svg\" alt=\"redact-pdf-mcp MCP server\" /></a>\n\n```bash\nclaude mcp add redact-pdf -- npx -y redact-pdf-mcp\n```\n\nThen ask: *\"Redact the personal data in ~/Documents/contract.pdf\"*, or *\"Anonymize\n~/Documents/contract.pdf with placeholders so I can paste it into an AI\"*.\n\n---\n\n## Your data\n\nYou are sending the document the agent is meant to protect, so this comes first.\n\n- **Never used to train AI models** — not ours, not Microsoft's, not anyone's. The Azure\n  AI services used for OCR and PII detection run with content logging disabled, so\n  document content is not retained or used for model improvement.\n- **Processed in the EU and Switzerland** on Microsoft Azure.\n- **Encrypted** with TLS 1.2+ in transit and AES-256 at rest.\n- **The original is deleted after processing** under the default `ephemeral` retention.\n  The redacted output is kept for your account's retention window (14 days by default,\n  configurable) and can be purged at any time with `DELETE /v1/jobs/{job_id}`.\n- **Certified infrastructure.** Azure holds SOC 2 Type II, ISO 27001, ISO 27017 and\n  ISO 27018 certifications and is HIPAA-eligible under Microsoft's BAA. Redact PDF AI\n  itself is not independently audited for these frameworks; it is built so legal, medical\n  and finance teams can use it inside their own compliance posture.\n- **The MCP server sends no telemetry of its own** — see\n  [what the server does locally](#what-the-server-does-locally).\n\nDetails: [redact-pdf.ai/security](https://www.redact-pdf.ai/security) ·\n[privacy policy](https://www.redact-pdf.ai/privacy)\n\n## Why not let the agent redact it itself?\n\nAn agent can find names in text. It cannot make a PDF safe on its own:\n\n- **A black box is not a redaction.** Drawing a rectangle over text leaves the text layer\n  underneath; anyone can select, copy or extract it. This server rasterizes each page and\n  drops the text layer and metadata, so there is nothing left to recover.\n- **Scans have no text to search.** Contracts, IDs and statements are often images. OCR\n  runs first, in 100+ languages, then PII detection runs over what it read.\n- **Detection is a model, not a regex.** Names, addresses and organizations do not follow a\n  pattern. The detector is purpose-built for PII, and your always-redact and never-redact\n  lists cover the rest.\n\n## Examples\n\nPrompts that work as-is once the server is installed:\n\n- *\"Redact the personal data in ~/Documents/lease.pdf before I send it to the agency.\"*\n- *\"Redact names, emails and IBANs in every PDF in ~/Downloads/statements, keep our company\n  name visible.\"* — the agent passes `pii_excluded_terms` for the company name and fans\n  out with `redact_pdf`.\n- *\"Here is a screenshot of a customer ticket. Remove the phone number and address, then\n  give me a PDF I can attach.\"* — images go in directly, no conversion.\n- *\"Try the redact-pdf demo on ~/Documents/contract.pdf so I can see what it does.\"* —\n  keyless, first page only.\n\n## Try it with no API key\n\nThe server ships a keyless tool, `try_demo`. Give it a file and it redacts the first\npage for real — no key, no account — and tells the agent what it found:\n\n> **You:** Use the redact-pdf server's try_demo tool on ~/Documents/contract.pdf.\n>\n> **Claude:** Redacted the first page of contract.pdf (4 pages). Personal data removed\n> on that page: Person, Email. Here is the redacted page (link valid 14 days). To redact\n> all 4 pages, a free account gets the first document (up to 5 pages) done in full, no card.\n\nCall it with no file and it runs a built-in synthetic sample instead, which is the\nzero-configuration connectivity check. Same thing from a terminal, no install:\n\n```bash\ncurl https://www.redact-pdf.ai/v1/demo\ncurl -F file=@contract.pdf https://www.redact-pdf.ai/v1/demo/redact\n```\n\n## What it does\n\n- **Permanent, irreversible redaction.** The underlying text is deleted, not masked. It\n  cannot be recovered by copy-paste, text extraction, or \"remove object\" in a PDF editor.\n- **PDFs and images.** Pass a PDF, JPEG or PNG. Photos and screenshots do not need converting\n  first; the output is a redacted PDF either way.\n- **Scanned documents.** OCR handles image-only PDFs and photos of documents.\n- **100+ languages** for entity detection.\n- **Eight entity types**: Person, Email, PhoneNumber, Address, Organization, Date, IBAN,\n  CreditCard — plus your own always-redact and never-redact term lists.\n- **EU/Swiss processing**, never used for AI training — see [Your data](#your-data).\n- **Pseudonymize instead of black boxes.** `mode: \"pseudonymize\"` replaces each entity with a\n  consistent tag (`[Person 1]`, `[Org 1]`, `[Address 1]`...), identical on every page and for every variant of\n  a name, so the document stays readable for a colleague or another AI. The text is still\n  removed, not covered, and `redact_pdf_and_wait` also returns the tag → original table (CSV).\n- **Human review when it matters.** `retention: \"studio\"` keeps the detected masks so a\n  person can check and adjust them before export.\n\n## Install\n\n### Claude Code\n\n```bash\nclaude mcp add redact-pdf --env REDACT_PDF_API_KEY=your_key -- npx -y redact-pdf-mcp\n```\n\n### Claude Desktop\n\n`claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"redact-pdf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"redact-pdf-mcp\"],\n      \"env\": { \"REDACT_PDF_API_KEY\": \"your_key\" }\n    }\n  }\n}\n```\n\n### Cursor\n\n`.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"redact-pdf\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"redact-pdf-mcp\"],\n      \"env\": { \"REDACT_PDF_API_KEY\": \"your_key\" }\n    }\n  }\n}\n```\n\n### VS Code\n\n```bash\ncode --add-mcp '{\"name\":\"redact-pdf\",\"command\":\"npx\",\"args\":[\"-y\",\"redact-pdf-mcp\"],\"env\":{\"REDACT_PDF_API_KEY\":\"your_key\"}}'\n```\n\nGet an API key at [redact-pdf.ai/sign-up](https://www.redact-pdf.ai/sign-up). A free account\ngets its first document (up to 5 pages) redacted in full, no card. Without a key,\n`try_demo` still works; everything else will tell the agent to ask you for one.\n\nA client that can't pass the key in the environment (Cowork drops a plugin MCP server whose\nconfig references a plugin setting, so the Claude plugin passes none) can save it instead: give the agent the key and it calls `set_api_key`, which\nchecks the key against the API and, when the client supports MCP elicitation, asks you to\napprove the account (email and the key's last four characters). A confirmed key is written to\n`~/.config/redact-pdf-mcp/key` (or `$XDG_CONFIG_HOME/redact-pdf-mcp/key`), readable by your user\nonly, and is never replaced without the same confirmation. A client without elicitation gets the\nkey for that session only, in memory, never over a key that still works, and every tool result\nnames the account. That keeps a key planted in a processed document from silently redirecting\nyour files. The tool never returns the key. You can also write the file yourself once (see the\nplugin README for the one-line command). `REDACT_PDF_API_KEY` takes priority when it is set; an\nempty value, or an unsubstituted placeholder such as `${user_config.api_key}`, counts as unset.\n\n## Tools\n\n| Tool | What it does |\n| --- | --- |\n| `redact_pdf_and_wait` | **Start here.** Upload, redact, wait, return the finished PDF. One call. |\n| `redact_pdf` | Start a job and return immediately, for redacting several documents in parallel. |\n| `get_job_status` | Poll a job: `uploaded` → `analyzing` → `redacting` → `redacted` \\| `error`. |\n| `download_redacted` | Fetch the redacted output for one document. |\n| `download_correspondence` | Fetch the tag → original table of a pseudonymized document (`mode: \"pseudonymize\"`). |\n| `try_demo` | Keyless. With a file: redact its first page for real. Without: run the built-in sample. |\n| `restore_names` | Put the real names back into what the agent wrote from the pseudonymized text. Local: a `.md`, `.txt` or `.docx` file, returns the output path and counts. Hosted: the text itself, returns a download link for the user and counts (see Re-identification below). Never a name. |\n| `get_account_status` | Check the API key is valid and see the account, before a big batch. |\n| `delete_job` | **Hosted only.** Delete a job now, with its original, redacted PDF, text version, correspondence table and restored texts, instead of waiting for retention. Destructive; the agent confirms with the user first. |\n| `set_api_key` | **Local only.** Check a key the user gives in the conversation and save it user-only on this machine, for clients that can't pass `REDACT_PDF_API_KEY`. Never returns the key. |\n\nRedaction rules, on either redact tool:\n\n| Argument | Effect |\n| --- | --- |\n| `pii_categories` | Restrict to specific entity types. Omit for account defaults. |\n| `pii_included_terms` | Always redact these, even if not detected as PII (codenames, case numbers). |\n| `pii_excluded_terms` | Never redact these, even if detected (your own company name). |\n| `retention` | `ephemeral` (default) deletes the original after processing. `studio` keeps masks for human review. |\n| `mode` | `redact` (default) draws black boxes. `pseudonymize` draws consistent tags such as `[Person 1]` and returns the correspondence table (stdio: written next to the PDF as `*-correspondence.csv`; remote: a 15-minute `correspondence_download_url` for the user, never the table itself) plus the document as text with the tags in place (`document_text`; past 32 KB, stdio writes `document_text_path` and remote returns the start plus a signed `document_text_url`). Also accepted by `try_demo`. |\n\n## Anonymize → let the AI work → put the names back\n\nThe local server closes the loop without the model ever seeing a name:\n\n1. `redact_pdf_and_wait` with `mode: \"pseudonymize\"` returns the redacted PDF, the\n   correspondence table on disk, and `document_text`: the document as text, every name\n   replaced by its tag. The agent works from that text.\n2. The agent writes its answer (summary, memo, letter) to a `.md`, `.txt` or `.docx` file,\n   keeping the tags as written.\n3. `restore_names` with that file and the `correspondence_path` writes\n   `<name>-restored.<ext>` with the real names, and returns only the path and counts.\n\nThe agent must not open the original document first, nor the correspondence CSV or the\nrestored file afterwards: any of those reads puts the personal data back into the\nconversation. The server instructions and tool descriptions say so explicitly.\n\n## Remote server\n\nThe package also ships a streamable-HTTP server for hosted use, where the API key travels\nper request instead of in the environment:\n\n```bash\nnpx redact-pdf-mcp-http     # listens on :8080/mcp\n```\n\n```\nPOST /mcp\nX-API-Key: your_key          (or: Authorization: Bearer your_key)\n```\n\nIt is **stateless** — no sessions, no stored keys, nothing kept between requests — so each\nrequest gets its own short-lived server instance and one caller's key can never leak into\nanother's tool call.\n\nThe handshake, `tools/list`, and `try_demo` work without a key, so a client can connect and\nverify the server before anyone signs up; every other tool returns `401` with a\n`WWW-Authenticate` challenge.\n\n### Re-identification (hosted)\n\n`restore_names` on the hosted server takes the `document_id`, the\n`text_version` that came with `document_text`, and the agent's tagged text (up\nto 500,000 characters). The server fetches that document's correspondence table\nitself, puts the real names back, and stores the result for the user: the tool\nreturns a 15-minute `restored_download_url` (a download page, the file only on\nclick) plus counts and the tags it could not restore. No original ever appears\nin a result. `text_version` pins the table: if the document was edited or\ndetected again in the Studio since the text was produced, the restore is\nrefused (`text_changed`) rather than putting in names that a tag no longer\nstands for. The stored file is deleted after an hour, or at once with the\ndocument.\n\n### Limits (hosted)\n\n| Variable | Default | Meaning |\n|---|---|---|\n| `REDACT_PDF_CALL_BUDGET_MS` | 210000 | Hard limit per request. When it passes, or the client disconnects, everything the request started (API calls, retry waits, polling, downloads) is cancelled. `redact_pdf_and_wait` waits at most 180 s on the hosted server and then returns the job id to resume with. |\n| `REDACT_PDF_RATE_PER_MINUTE` | 120 | Calls per minute per signed-in user or API key (each JSON-RPC message counts; batched tool calls are refused). |\n| `REDACT_PDF_ANON_RATE_PER_MINUTE` | 30 | Calls per minute per client address without credentials. |\n| `REDACT_PDF_MAX_HEAVY` | 8 | Concurrent redactions / demo calls per instance (503 beyond). Status reads and links are never blocked by them. |\n| `REDACT_PDF_MAX_HEAVY_PER_CALLER` | 2 | Concurrent redactions per caller (429 beyond). |\n| `REDACT_PDF_MAX_DEMO` | 2 | Concurrent `try_demo` calls per instance, one per address: a pool of their own, so free calls never take a paid redaction's slot. |\n| `REDACT_PDF_KEYED_RATE_PER_ADDRESS` | 240 | Calls per minute per address across every API key it sends (keys are not verified here, so made-up keys cannot mint fresh budgets). |\n| `REDACT_PDF_TRUST_PROXY` | off | `1` behind a proxy that appends to `X-Forwarded-For` (Azure App Service): the LAST entry is used, and only if it is an IP address. IPv6 is limited per /64. |\n\nThe hosted server needs Node 20.3 or later (`AbortSignal.any`); stdio runs on any Node 20.\n\nRefusals are logged as `{\"event\":\"admission\",\"reason\":…}` and cancelled calls as `{\"event\":\"cancelled\",\"reason\":\"budget\"|\"client_closed\"}` (no keys, addresses or arguments). A refused tool call is answered as a tool error carrying `retry_after_seconds`, so the model sees the advice.\n\nAll limits are per process. URL fetches (`file_url`, ChatGPT files) connect to\nthe exact address that passed the public-address check: a DNS record that\nchanges between the check and the connection cannot redirect it.\n\n### OAuth (hosted connector)\n\nSet these and the server also acts as an OAuth 2.1 protected resource (MCP authorization\nspec), so Claude and ChatGPT can connect with a sign-in instead of a key:\n\n| Variable | Meaning |\n|---|---|\n| `REDACT_PDF_OAUTH_RESOURCE` | Canonical URL of this endpoint, e.g. `https://mcp.redact-pdf.ai/mcp`. Tokens must carry it as `aud`. |\n| `REDACT_PDF_OAUTH_ISSUER` | The authorization server (Clerk), e.g. `https://clerk.redact-pdf.ai`. |\n| `REDACT_PDF_SERVICE_SECRET` | ≥ 32 bytes, shared with the API only. Used to sign the per-request service assertion. |\n| `REDACT_PDF_OAUTH_REQUIRED_SCOPES` | Optional. Scopes a token must carry (403 `insufficient_scope` otherwise). |\n| `REDACT_PDF_OAUTH_SCOPES` | Optional. Extra scopes to advertise. |\n| `REDACT_PDF_OAUTH_JWKS_URL` | Optional. Defaults to `<issuer>/.well-known/jwks.json`. |\n| `REDACT_PDF_OAUTH_ALLOW_MISSING_AUD_CLIENTS` | Optional, empty by default. OAuth client ids whose tokens may lack `aud`. A wrong `aud` is never accepted. |\n\nResource and issuer are set together or not at all; a partial or insecure configuration\nstops the server at startup. With OAuth on:\n\n- `/.well-known/oauth-protected-resource/mcp` (and the root form) serves the RFC 9728\n  metadata; a call that needs sign-in gets `401` with\n  `WWW-Authenticate: Bearer resource_metadata=\"…\"`.\n- Access tokens must be Clerk OAuth tokens in **JWT format**, signed RS256 by the issuer,\n  for this resource. They are verified locally (cached JWKS) **before** the request body\n  is read.\n- The user's token is never forwarded. The server calls the API with a 2-minute HS256\n  service assertion (`X-Service-Assertion`) naming the verified user, minted per API\n  request.\n- API keys still work: `X-API-Key`, or a bearer value starting `rdp_live_`.\n\nDocuments reach the hosted server one of three ways (it has no access to your\nfilesystem):\n\n- **`create_upload_link`** (the default). Returns a 30-minute page on\n  www.redact-pdf.ai where the user chooses the file; it goes from their browser\n  straight to storage and never passes through the AI conversation. The agent\n  then calls `redact_pdf_and_wait` with `upload_id`. Until the user has\n  uploaded, that call answers `status: \"waiting_for_upload\"` (not an error;\n  nothing is created or billed).\n- **`file_base64`**, for files under 1 MB only. Larger ones are refused with a\n  pointer to `create_upload_link`, and request bodies are capped accordingly\n  (~1.8 MB).\n- **ChatGPT's `file` parameter** (`_meta[\"openai/fileParams\"]`), off by default:\n  set `REDACT_PDF_ENABLE_CHATGPT_FILES=1`. It is a URL fetch on the caller's\n  behalf (any MCP client can fill it, not only ChatGPT) through the same guard\n  as `file_url`. Set `REDACT_PDF_CHATGPT_FILE_HOSTS` to the hosts ChatGPT serves\n  files from (comma-separated; a leading `.` matches subdomains); without it the\n  parameter also requires `REDACT_PDF_ENABLE_URL_INPUT=1`. Keep it off until the\n  guard pins DNS.\n\nAn upload link makes one job. Once its job exists, the page refuses a second\nfile (\"already used, ask for a new link\") and the API answers `410` to any new\nrequest on it, so the agent is never handed the first file's job for a second\nfile. Hosted results carry document ids, never the user's file names.\n\nResults never carry files. The redacted PDF and the correspondence table come\nback as signed links (`download_url`, `correspondence_download_url`) minted by\n`POST /v1/documents/{id}/links`; a pseudonymized text comes back inline, or for\na long one as its start plus a signed `document_text_url`. Each link works for\n15 minutes without any credential, is bound to one document, its owner and one\nkind, and re-checks ownership, retention, readiness and the account balance\nwhen it is used. A PDF or table link opens a page with a Download button: a\nplain GET (a fetch tool, a link preview) never receives the file. Links need\n`REDACT_PDF_SERVICE_SECRET` on the API. See CHANGELOG.md for what changed in\n0.5.0.\n\nFetching a document by URL is **off by default** on the remote server. The address check\nis real — URLs resolving to loopback, private, or link-local addresses are refused, and\nevery redirect hop is re-checked — but the socket resolves the hostname a second time\nafter that check, so a DNS-rebinding attacker with a short TTL can still have the server\nvalidate one address and connect to another. Closing that requires pinning the connection\nto the validated address, which is not implemented yet, so an internet-reachable server\ndoes not offer the surface at all.\n\nSet `REDACT_PDF_ENABLE_URL_INPUT=1` to accept `file_url`, and only where you have your own\negress controls (a network policy or allowlisting proxy) in front of the server.\n`REDACT_PDF_ALLOW_PRIVATE_URLS=1` additionally permits private addresses, for a\nself-hosted instance fetching from internal storage.\n\nstdio mode is unaffected: it runs on your own machine, where fetching a URL carries no\nprivilege you do not already have.\n\n| Variable | Default | Purpose |\n| --- | --- | --- |\n| `REDACT_PDF_API_KEY` | — | API key (stdio mode only; remote takes it per request). Empty or `${...}` counts as unset, and the key saved by `set_api_key` is used instead. |\n| `REDACT_PDF_BASE_URL` | `https://www.redact-pdf.ai` | Point at a different API host. |\n| `PORT` | `8080` | HTTP server port. |\n| `REDACT_PDF_MCP_PATH` | `/mcp` | HTTP endpoint path. |\n| `REDACT_PDF_ENABLE_URL_INPUT` | unset | Accept `file_url` on the remote server. Off by default — see the DNS-rebinding note above. |\n| `REDACT_PDF_ALLOW_PRIVATE_URLS` | unset | Self-hosted only: permit `file_url` to reach private addresses. Never set this on a publicly reachable server. |\n| `REDACT_PDF_DIRECTORY` | unset | Hosted directory build. `openai`: no `try_demo` (listed or keyless) and no free, price or credit wording in instructions, tool descriptions, results or errors, as the OpenAI plugin guidelines require. Anything else stops the server at startup. |\n| `REDACT_PDF_OPENAI_APPS_CHALLENGE` | unset | OpenAI's domain-verification token, served as plain text at `/.well-known/openai-apps-challenge` (404 while unset). |\n\n## What the server does locally\n\n- **No telemetry.** The server makes exactly the API calls its tools describe, and nothing\n  else. No analytics, no error reporting, no phone-home.\n- **Stateless.** No database, no cache, no disk writes except the files you asked for, at\n  the paths you asked for, and the key file when you call `set_api_key`.\n- **Your originals stay yours.** In stdio mode the input file is read and never modified.\n  Under the default `ephemeral` retention the API deletes the original after processing.\n- **Idempotent by default.** The idempotency key is derived from the file bytes and the\n  redaction settings, so an agent that retries the same call gets the *same* job back\n  instead of redacting — and billing — twice. That cache lasts 24 hours; pass an explicit\n  `idempotency_key` when you genuinely want a second, separate redaction of the same file.\n- **Never overwrites.** In stdio mode the redacted PDF is written atomically and the tool\n  refuses to clobber an existing file.\n\n## Privacy Policy\n\nThe full policy is at [redact-pdf.ai/privacy](https://www.redact-pdf.ai/privacy). It covers\nthe website, the app and the API this server calls. In short:\n\n- **What is collected.** The documents you send, their processing metadata (status, page\n  count, selected PII categories) and the redaction masks; your account identifier and\n  email if you use an API key; billing data if you pay. This MCP server itself collects\n  nothing and sends no telemetry.\n- **How it is used.** To run the redaction you asked for, and to operate, secure and bill\n  your account. Documents are processed for OCR and PII detection only and are never used\n  to train AI models.\n- **Where it is stored.** Microsoft Azure in the EU and Switzerland, encrypted in transit\n  (TLS 1.2+) and at rest (AES-256).\n- **Who it is shared with.** Documents go only to Microsoft Azure (storage, OCR and PII\n  detection). Account and billing data go to Clerk and Stripe. Internal operational alerts,\n  which can include a file name, go to the team's Slack. The policy lists every\n  subprocessor.\n- **How long it is kept.** Under the default `ephemeral` retention the original is deleted\n  after processing; the redacted output follows your account's retention window (14 days\n  by default) and can be deleted at any time. Files sent to the keyless `try_demo` are\n  deleted after the first page is redacted; that page is kept 14 days.\n- **Contact.** info@redact-pdf.ai for privacy requests and questions.\n\n## Limits\n\n- 50 MB per PDF, 10 MB per image, 100 files per job.\n- PDF, JPEG and PNG in; always a PDF out. Convert other formats (DOCX, TIFF, HEIC) to PDF first.\n- On the remote server, base64 inflates a document by about a third, so prefer `file_url`\n  for anything large.\n- Passing an empty `pii_categories` list is rejected: to the API an empty list means\n  \"redact nothing\", which would return an untouched file reported as redacted. Omit the\n  argument to use your account defaults.\n- Billed per page against your plan quota and credit packs, after the free first document.\n  A `quota_exceeded` error means top up — the tools tell the agent not to retry it.\n\n## Development\n\n```bash\nnpm install\nnpm run build\nnpm test                 # offline unit + tool tests\nnpm run test:integration # hits the live keyless demo endpoint; no key needed\n```\n\n## Links\n\n- API docs: [redact-pdf.ai/developers](https://www.redact-pdf.ai/developers)\n- Security and data handling: [redact-pdf.ai/security](https://www.redact-pdf.ai/security)\n- OpenAPI spec: [redact-pdf.ai/openapi.yaml](https://www.redact-pdf.ai/openapi.yaml)\n- LLM index: [redact-pdf.ai/llms.txt](https://www.redact-pdf.ai/llms.txt)\n\nSupport questions about redaction quality, billing, or your account go to\ninfo@redact-pdf.ai — GitHub issues here are for the MCP server itself.\n\nMIT licensed.\n","readmeFilename":"README.md"}