{"_id":"reddit-mcp-buddy","_rev":"17-7f5d6e3f9ca317ebed77a06304812665","name":"reddit-mcp-buddy","dist-tags":{"latest":"1.3.0"},"versions":{"1.1.0":{"name":"reddit-mcp-buddy","version":"1.1.0","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.0","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"c4b34aa1ec99bd9435cc7a9f4b33520ca06a18e3","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.0.tgz","fileCount":47,"integrity":"sha512-CV2oxbkjLj57MVO3RQk9xiE4jf7/YJ2PlGL/J0C+KJfKhAS067o3phIBP+7DsEbVOtQIRGVhA/kUTSa9PkRe9w==","signatures":[{"sig":"MEUCIAipl/aml2l3sCwPv2DK1qUIWY1ISgYklbm8QY35KGjGAiEAyzE6E0Yl/KMhwfyB0ag0FhI7wMsk/PBxxEV1fTtIcbU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":219859},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"cd6c5a586d36ced1aceac2904035a3f47ae37c84","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && chmod +x dist/cli.js","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.0_1758123586737_0.5574129203963669","host":"s3://npm-registry-packages-npm-production"}},"1.1.1":{"name":"reddit-mcp-buddy","version":"1.1.1","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.1","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"cc10efabfe593e10996cf9444bf0fc835cd29c91","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.1.tgz","fileCount":47,"integrity":"sha512-ukr05ama5AlbziOtyUI3s9SI72hKlKaNHNXhqbGi4OcDIAO5L3F83zMSHn1ILY62ezHjCO5gZ0wihHolutjAdw==","signatures":[{"sig":"MEUCIQD8CVIwnRe8NvuGGMXJN6BHnWHUhGElGAntEpLc6AJ+mAIgKqRc3MCYx2X+JJIr6maiLzl1hMf7pS2bs+ZeaioIueE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":222979},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"dc606a4696b154e3975aed878842fde67b6e7da3","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && chmod +x dist/cli.js","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.1_1758365098411_0.8345714418888008","host":"s3://npm-registry-packages-npm-production"}},"1.1.2":{"name":"reddit-mcp-buddy","version":"1.1.2","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.2","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"e031ab39ffe8af91ef9752cf1be60367f87e0a22","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.2.tgz","fileCount":47,"integrity":"sha512-/fsRHEgLgOTB7ZBxI36Sgz4Uyc4PVXCphJDiZog4UhAg0JRJm4EKSct1T1UR18hpYbKPb3ejL708EQixo3qr+Q==","signatures":[{"sig":"MEQCIEa3KMiYnucLCQt7Hx4nN7sVqQj00Jr3AVNxip8kJi3oAiBJog1IkkmAuy+7gLYxN4mIjRFeUrD0GnQKVNf5jzfJPA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":224707},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"cb5d50a5e4b9e67b966bc6404f0d56f5813cd7cf","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && chmod +x dist/cli.js","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.2_1758473459059_0.94354181806328","host":"s3://npm-registry-packages-npm-production"}},"1.1.3":{"name":"reddit-mcp-buddy","version":"1.1.3","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.3","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"3cc5fbe399c319401b38f3800b4a1bf158806118","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.3.tgz","fileCount":47,"integrity":"sha512-LWYVGgmTwvjybfVN2GVLT9WYR3sqkz44efFSGiWrL9Vb9Q6tLlJXaILVmBqA7rk6iaqdsrJC+SPcxqJgxNk4xQ==","signatures":[{"sig":"MEYCIQCSL5jozF7gMyLmXpMFBmdF2kMFLjryKl1/SOIlimW4MAIhAJgENwkA6vznM/XzYxSmdbGU8+H7Fx6iVF9vWMEbFpum","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":224707},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"a12484981d7ddc040a00153a140b5cee52a124a5","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && chmod +x dist/cli.js","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.3_1758474653872_0.898266369547976","host":"s3://npm-registry-packages-npm-production"}},"1.1.4":{"name":"reddit-mcp-buddy","version":"1.1.4","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.4","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"38491b145b2e3822f727066b82eb8e5c8fd81395","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.4.tgz","fileCount":47,"integrity":"sha512-nBgHdsf1IrjVy7+R+16Q+LxdQIKiNMMwHeHiNCc4MWsRmG3aJxDpg1/58mOZo4jcuSjxn/ChHtXkBE4yQexc+g==","signatures":[{"sig":"MEUCIQCvgW7luD4VHSN10YWVSqa/LvI87zf1fTMzKabjqTda3wIgGDka+OhXgkbdzFsemm5uO8n8hcYDljbuIG2Dsx5u7ac=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":224707},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"02f2092b6788ff0123cc24dcfbbde97f542b7123","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && chmod +x dist/cli.js","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.4_1758475072159_0.09965687830970871","host":"s3://npm-registry-packages-npm-production"}},"1.1.5":{"name":"reddit-mcp-buddy","version":"1.1.5","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.5","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"a9fd8390ef6f76c604a09906edb76327c78280fe","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.5.tgz","fileCount":47,"integrity":"sha512-csDISWOTQUYV23R4AuXsROPZXaFvzJn7wiRNdwtneXajz+9ZatsTZvoyzbH4JjVAA+3S3D0NjO/TvXgREQKkkA==","signatures":[{"sig":"MEUCIETB/oY6EvMEnJK4AaRtHKgFigB3qAAcQFX+/TUOS8nHAiEArrAWkxssoB6j11ymYUVSGk+exysq7kt5HDn7iUIqjbE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":224707},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"dc43c034a3548bdd26aa067ad52759470465d6a3","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && chmod +x dist/cli.js","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.5_1758476676712_0.31681206172733556","host":"s3://npm-registry-packages-npm-production"}},"1.1.6":{"name":"reddit-mcp-buddy","version":"1.1.6","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.6","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"476cbe53d0f4522e10e10ce40fb5320fcd86b643","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.6.tgz","fileCount":47,"integrity":"sha512-RKxQDSW5XjPVfEKLFeDmmHEm/eHa89Hjocdt4lTYmTUfqba9GP2nuVz7CjDqvhC865VW1ff/SvHDy9D/eNRBxQ==","signatures":[{"sig":"MEQCIDFk8GA2wj95N9di6/+XX9b02lt/v06mnUNZruWJcGbGAiB5pJqNZgzDDne0UJP5/CeZr/K3iPkOLy21kgeqdXmRyw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":224707},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"da942bb671a2cbd0e845bf86ef2133e6e48164ab","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && chmod +x dist/cli.js","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.6_1758477713975_0.6692635463015177","host":"s3://npm-registry-packages-npm-production"}},"1.1.7":{"name":"reddit-mcp-buddy","version":"1.1.7","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.7","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"3afe3b442272e71f0f9c2dc8ad61a1b14cb27562","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.7.tgz","fileCount":47,"integrity":"sha512-JtnYj9briHz+gomeBttDJTar8SRM0t28P/M1A76pAr/urTVygDV4mkeXgARyVrWJADy1xDuYfpBK/w7XSSTB3w==","signatures":[{"sig":"MEYCIQD17MRGT5myFbqgVsvJB9FH2kXBawZhi0FpqaEFxzWJhQIhAK3f/NE4giOQjq5YmqBj/4XV8c0aE8mzzD9Y/s6x8gqE","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":221796},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"aa27fe8a1bc5d4a66840b3f0dedf4f93dd6ba84d","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","zod-to-json-schema":"^3.24.6","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.7_1759238599150_0.4990530829717654","host":"s3://npm-registry-packages-npm-production"}},"1.1.8":{"name":"reddit-mcp-buddy","version":"1.1.8","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.8","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"93d993bb8e20d36793ca23a1845866dc17678e17","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.8.tgz","fileCount":47,"integrity":"sha512-I7U9DMdZ4aT+1NVenObdOytGMW3JkrqJ17ZGmDC9aUAzGx+J79LBU4QndlwCLF6eQSYzalLITpmoNmJX5EpYug==","signatures":[{"sig":"MEYCIQC8eXgyWD+l6gaVYNlwdDca0MeYv3iOciz0QZ8j+E6/qgIhANlLyczmX50goMTQ5c4CoKCfUydecImcJYZaZiinGEW6","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":221796},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"bb01bf745afa9f089448e4ffdb6abe2a22ce6588","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","zod-to-json-schema":"^3.24.6","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.8_1759238729081_0.5194504812688039","host":"s3://npm-registry-packages-npm-production"}},"1.1.9":{"name":"reddit-mcp-buddy","version":"1.1.9","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.9","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"7c56421a7c06ca3450f119b141314c264439e48f","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.9.tgz","fileCount":47,"integrity":"sha512-Ne4CqlBqdlNqgggafEjo5qLodruTsAt1Itm3rfxvaFoLF7U7MerG1j3k0PZhaib7YBJJkVuvZ7NpMAUNJLqdMw==","signatures":[{"sig":"MEQCIH7j89GZhmj+6Mhc8tR3JJ07PYZe44NLmzo11GVNJOVzAiAyBFNW4jVy9DjphvHt5O85uJRReLK2k03Wl9L2efAcyg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":221796},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"e53a83ebc3915481d3f0dd265f5d475c9f8aa732","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","zod-to-json-schema":"^3.24.6","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.9_1759238922093_0.839328118397926","host":"s3://npm-registry-packages-npm-production"}},"1.1.10":{"name":"reddit-mcp-buddy","version":"1.1.10","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.10","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"03d9613cedff86f54c91b6327f896a720723969b","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.10.tgz","fileCount":47,"integrity":"sha512-6MflF/cs1aoHPkFT26a5f1iUWgr60Z1po9U+85dodyAOddWeuIDvPDy0rSbbgQ998bLtP1yE0QODKEf3dcA3dw==","signatures":[{"sig":"MEUCIGYRqNi1R+9fGcnxJ/oKYXvToAqIzNb7SGnxApKS+4KQAiEAkR2g07Tg6BilNUv9jSH/5l2n2uOWKEjceIzwO4K5aeo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":221799},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"8164f0aa988573052711db6207a18cd77458a151","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"vitest","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"vitest --coverage","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"karanb192","email":"karanb192@gmail.com"},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"10.8.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"20.19.5","dependencies":{"zod":"^3.23.8","zod-to-json-schema":"^3.24.6","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.10_1759240015834_0.8568065127902664","host":"s3://npm-registry-packages-npm-production"}},"1.1.12":{"name":"reddit-mcp-buddy","version":"1.1.12","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.12","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"c0f62e00553a81e30c7e6d3f05bb9605e947bf0b","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.12.tgz","fileCount":47,"integrity":"sha512-rv1oLw3kwqw8XYJhDXviOIiIs5A8goRd/6fwV8kOzsBPpiAEuLdFmXiKoz4gHeNTADDuRfseCr4Aj8L/CQ7oOA==","signatures":[{"sig":"MEUCIQCHMtsphTySq3rZoKUNagR9RnPS1MYpKyA6e9NL6dKTSwIgTOoiZoEsHC3gA9XVZoZzsDq9vCVcZLHs5tx7TfZUGZU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reddit-mcp-buddy@1.1.12","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":281550},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"41c52430d18e499e778c882d4503448bd934c7f4","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"bash tests/test-unit.sh","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","test:all":"bash tests/test-unit.sh && bash tests/test-integration.sh","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:integration":"bash tests/test-integration.sh","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:81af05ef-7512-450d-980f-8d77870234af"}},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"11.6.2","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"24.13.0","dependencies":{"zod":"^3.23.8","zod-to-json-schema":"^3.24.6","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.12_1771654707946_0.23224148724476268","host":"s3://npm-registry-packages-npm-production"}},"1.1.13":{"name":"reddit-mcp-buddy","version":"1.1.13","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.13","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"01bcd622e454675003f697d987f72edad2a5ba52","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.13.tgz","fileCount":47,"integrity":"sha512-9HY4UTPS5oU+tP0Frg7wUi//s849nlFcYaoLfEKLyhO2lNdwJDCtVeXrXN+1OBQ18+8olD36YjChFdyG/k2gVA==","signatures":[{"sig":"MEUCIAseug7ANyLQAE2V4vC2hp/4pMGdn6EuUrBsjDHNRV+SAiEAx1lrO1UOqX58eNGUIzDAIxSh5lcWhn3fdn0Rl6yPwQU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reddit-mcp-buddy@1.1.13","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":283478},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"58e0ddef0c16ae033dfdf3dba85d85fd9aa95c01","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"bash tests/test-unit.sh","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","test:all":"bash tests/test-unit.sh && bash tests/test-integration.sh","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:integration":"bash tests/test-integration.sh","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:81af05ef-7512-450d-980f-8d77870234af"}},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"11.12.1","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"24.15.0","dependencies":{"zod":"^3.23.8","zod-to-json-schema":"^3.24.6","@modelcontextprotocol/sdk":"^1.17.5"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","vitest":"^3.2.4","typescript":"^5.5.3","@types/node":"^20.14.10","@vitest/coverage-v8":"^3.2.4","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.13_1779820045824_0.7373987295395714","host":"s3://npm-registry-packages-npm-production"}},"1.1.14":{"name":"reddit-mcp-buddy","version":"1.1.14","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.1.14","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"f805791b252bbce04025d69c9c6647a9033366ed","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.1.14.tgz","fileCount":47,"integrity":"sha512-+O1+W5dcGiY5iwtHG4+dYOS9w+nhPtL2vGqT9+Qtp0Q4ymdfQZhznJc6+27O/PHt/FShBTmOjhj3+Y49cKUU7Q==","signatures":[{"sig":"MEUCIQDbs+efdd12bhKeP6fCBpSAKEfUMsfyQuheB3p9f/7iVQIgeQiUGUzo0GrwbNWApbC6s0Rz8dYOFf0cnpflP0UA6Ac=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reddit-mcp-buddy@1.1.14","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":328866},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18.0.0"},"gitHead":"dfd3f0941a0ae18ef108a9f7788dd0f350d610b3","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","lint":"eslint src --ext .ts","test":"bash tests/test-unit.sh","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","test:all":"bash tests/test-unit.sh && bash tests/test-integration.sh","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","prepublishOnly":"npm run build","docker:run-http":"docker run -p 3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:integration":"bash tests/test-integration.sh","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:81af05ef-7512-450d-980f-8d77870234af"}},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"11.16.0","description":"Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^3.23.8","zod-to-json-schema":"^3.24.6","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.16.2","eslint":"^8.57.0","typescript":"^5.5.3","@types/node":"^20.14.10","@typescript-eslint/parser":"^7.16.0","@typescript-eslint/eslint-plugin":"^7.16.0"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.1.14_1785320418545_0.46485648066067675","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"reddit-mcp-buddy","version":"1.2.0","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.2.0","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"2861345019f44228bb84fdbcd60e4608d94fabd2","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.2.0.tgz","fileCount":63,"integrity":"sha512-u8e5BiasPud1zBh4CGGdvE9fEdyZtJ2uc94p1x4cQphyuAnXADo5hdRycZvd14bsY2VLBzKg/9iH8OcM2vgp/Q==","signatures":[{"sig":"MEYCIQCUs72Kmdsz38ESA1FM9isTAUY3zakdmpRhvtzhcX1TiAIhALTOXo8ooXhDtiMCcwx4Vn/f5/Tk/jdKUB2+DUREaIlr","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDgdpjJayzX1CDSg0M0gri2ztPfzNxteYwSAblZE9m03QIgIwnCaVZbhi2o6M0z49Apw6y65WBfN9Z5Rcwx79Wnybc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reddit-mcp-buddy@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":554002},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"9f099fa93df8db729d115b6ac25d01bb4a1ccf49","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","test":"bash tests/test-unit.sh","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","test:all":"bash tests/test-unit.sh && bash tests/test-integration.sh","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"npm run build && c8 --include=dist/core/write-gate.js --include=dist/services/write-errors.js --include=dist/tools/write.js --check-coverage --lines 100 --functions 100 --statements 100 --branches 100 --per-file --reporter=text node tests/write-unit.mjs","prepublishOnly":"npm run build","docker:run-http":"docker run -p 127.0.0.1:3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:integration":"bash tests/test-integration.sh","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"81af05ef-7512-450d-980f-8d77870234af"}},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"11.20.0","description":"Clean, LLM-optimized Reddit MCP server: browse, search, and analyze Reddit, with opt-in posting and commenting behind server-side safety rails.","directories":{},"_nodeVersion":"26.13.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"devDependencies":{"c8":"^12.0.0","tsx":"^4.16.2","typescript":"^5.5.3","@types/node":"^20.14.10"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.2.0_1793587473775_0.7426910809870938","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"reddit-mcp-buddy","version":"1.2.1","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","_id":"reddit-mcp-buddy@1.2.1","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"dist":{"shasum":"a94c42faff64cbb2e0725e2ccdb42c919550ada6","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.2.1.tgz","fileCount":63,"integrity":"sha512-9H9TpmJTmekjUs9aFISVIVo31grhOqmuHWLjpLxiiBoMrFP7yTfLZgAieYbMS8tr6rUolD4UML94WRRaDfPslA==","signatures":[{"sig":"MEQCIFLnVn9b2tDyZgsEjwBn6f7k7TXoLZCZA/jjNxezkCD+AiBmExW6xvr1aIiFsT4Fjq/FJoHG75lYFay5Vbty7muuIA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDUmgAsWJBm9927x58/+Yea4ZZ1njPRKECHv1Hoxdws/QIgJGgCQF3sJraDzNnO29vEa8hXcb53HGRwQmRfB2uGkOE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reddit-mcp-buddy@1.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":562911},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=20.0.0"},"gitHead":"59d533305139603b5b9cc6dd16460862b8f21c62","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","test":"bash tests/test-unit.sh","build":"tsc && (chmod +x dist/cli.js 2>/dev/null || true)","start":"node dist/index.js","test:all":"bash tests/test-unit.sh && bash tests/test-integration.sh","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"REDDIT_BUDDY_HTTP=true node dist/index.js","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"npm run build && c8 --include=dist/core/write-gate.js --include=dist/services/write-errors.js --include=dist/tools/write.js --check-coverage --lines 100 --functions 100 --statements 100 --branches 100 --per-file --reporter=text node tests/write-unit.mjs","prepublishOnly":"npm run build","docker:run-http":"docker run -p 127.0.0.1:3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:integration":"bash tests/test-integration.sh","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:anon":"node scripts/rate-limit-tester.cjs anonymous 15","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"81af05ef-7512-450d-980f-8d77870234af"}},"overrides":{"c8":{"glob":"^14.0.2","minimatch":"^11.0.1"}},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"11.20.0","description":"Clean, LLM-optimized Reddit MCP server: browse, search, and analyze Reddit, with opt-in posting and commenting behind server-side safety rails.","directories":{},"_nodeVersion":"26.13.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"devDependencies":{"c8":"^12.0.0","tsx":"^4.16.2","typescript":"^5.5.3","@types/node":"^20.14.10"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp-buddy_1.2.1_1794330470106_0.05882346866311983","host":"s3://npm-registry-packages-npm-production"}},"1.3.0":{"_id":"reddit-mcp-buddy@1.3.0","bin":{"reddit-buddy":"dist/cli.js","reddit-mcp-buddy":"dist/cli.js"},"bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"dist":{"shasum":"aef8e4db69edabf5b3f426183eb6ee8a35bab1b2","tarball":"https://registry.npmjs.org/reddit-mcp-buddy/-/reddit-mcp-buddy-1.3.0.tgz","fileCount":67,"integrity":"sha512-j/uyVeatgVgJX/QkCoF4j+SaYSRnaiilF99WK8zp+V0UeNTB2fF18JOXb2qVKQqQBgg7MbJ57tugOSY6uD304A==","signatures":[{"sig":"MEYCIQDhk82qrn8Jp8SEvpKW4u090oZMq1OMCEqjeFa9QwdRjAIhANMiN9tPC9nQC8QU+qTUAoKjTmg9yHXRLmuZ3jtGuiwD","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDIYeDlmkodCei6if13xBqWOB+SVLsx9c71y1s95rYaawIgEXTrnQud6yyoOwlZn8CRTOzhaM8UvK1cBj/Uc9uMcas="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/reddit-mcp-buddy@1.3.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":610636},"main":"dist/index.js","name":"reddit-mcp-buddy","type":"module","types":"./dist/index.d.ts","author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"engines":{"node":">=20.0.0"},"gitHead":"90ab5574aad6e6e86a14e03bbbbf0fad2fb3a657","license":"MIT","mcpName":"io.github.karanb192/reddit-mcp-buddy","scripts":{"dev":"tsx watch src/index.ts","test":"bash tests/test-unit.sh","build":"tsc && node -e \"try { require('fs').chmodSync('dist/cli.js', 0o755) } catch {}\"","start":"node dist/index.js","test:all":"bash tests/test-unit.sh && bash tests/test-integration.sh","typecheck":"tsc --noEmit","docker:run":"docker run -it reddit-mcp-buddy","start:http":"node -e \"process.env.REDDIT_BUDDY_HTTP='true'; import('./dist/index.js')\"","docker:build":"docker build -t reddit-mcp-buddy .","test:coverage":"npm run build && c8 --include=dist/core/write-gate.js --include=dist/services/write-errors.js --include=dist/tools/write.js --check-coverage --lines 100 --functions 100 --statements 100 --branches 100 --per-file --reporter=text node tests/write-unit.mjs","prepublishOnly":"npm run build","docker:run-http":"docker run -p 127.0.0.1:3000:3000 -e REDDIT_BUDDY_HTTP=true reddit-mcp-buddy","test:rate-limit":"node scripts/rate-limit-tester.cjs","test:integration":"bash tests/test-integration.sh","test:rate-limit:app":"node scripts/rate-limit-tester.cjs app-only 70","test:rate-limit:auth":"node scripts/rate-limit-tester.cjs auth 120"},"version":"1.3.0","_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"81af05ef-7512-450d-980f-8d77870234af"}},"homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"overrides":{"c8":{"glob":"^14.0.2","minimatch":"^11.0.1"}},"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"_npmVersion":"11.20.0","description":"Clean, LLM-optimized Reddit MCP server: browse, search, and analyze Reddit, with opt-in posting and commenting behind server-side safety rails.","directories":{},"maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"_nodeVersion":"26.13.0","dependencies":{"zod":"^4.6.7","@modelcontextprotocol/sdk":"^1.32.2"},"_hasShrinkwrap":false,"devDependencies":{"c8":"^12.0.0","tsx":"^4.16.2","typescript":"^5.5.3","@types/node":"^20.14.10"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/reddit-mcp-buddy_1.3.0_1794387774290_0.6432503295664408"}}},"time":{"created":"2025-09-17T15:39:46.653Z","modified":"2026-11-11T09:02:54.749Z","1.1.0":"2025-09-17T15:39:46.930Z","1.1.1":"2025-09-20T10:44:58.715Z","1.1.2":"2025-09-21T16:50:59.291Z","1.1.3":"2025-09-21T17:10:54.068Z","1.1.4":"2025-09-21T17:17:52.380Z","1.1.5":"2025-09-21T17:44:36.907Z","1.1.6":"2025-09-21T18:01:54.174Z","1.1.7":"2025-09-30T13:23:19.369Z","1.1.8":"2025-09-30T13:25:29.269Z","1.1.9":"2025-09-30T13:28:42.300Z","1.1.10":"2025-09-30T13:46:56.002Z","1.1.12":"2026-02-21T06:18:28.103Z","1.1.13":"2026-05-26T18:27:25.959Z","1.1.14":"2026-07-29T10:20:18.688Z","1.2.0":"2026-11-02T02:44:33.873Z","1.2.1":"2026-11-10T17:07:50.280Z","1.3.0":"2026-11-11T09:02:54.398Z"},"bugs":{"url":"https://github.com/karanb192/reddit-mcp-buddy/issues"},"author":{"name":"Karan Bansal","email":"karanb192@gmail.com"},"license":"MIT","homepage":"https://github.com/karanb192/reddit-mcp-buddy#readme","keywords":["reddit","mcp","claude","ai","assistant","model-context-protocol"],"repository":{"url":"git+https://github.com/karanb192/reddit-mcp-buddy.git","type":"git"},"description":"Clean, LLM-optimized Reddit MCP server: browse, search, and analyze Reddit, with opt-in posting and commenting behind server-side safety rails.","maintainers":[{"name":"karanb192","email":"karanb192@gmail.com"}],"readme":"# <img src=\"assets/reddit-mcp-buddy-icon-white-background.png\" width=\"48\" align=\"center\"/> Reddit MCP Buddy\n\n### Reddit Browser for Claude Desktop and AI Assistants\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server for browsing Reddit, searching posts, and analyzing user activity. It needs existing approved Reddit API credentials. Version 1.2.0 added optional posting and commenting with per-process caps and a client-dependent confirmation flow. See [Posting](#posting-v120).\n\n> **Reddit is closing the access this server uses.** Only people who already hold approved Reddit API credentials can use it.\n>\n> - **2026-10-31:** Reddit stopped accepting new requests for public API access ([migration post](https://www.reddit.com/r/redditdev/comments/1wubcvf/moving_data_api_apps_to_the_developer_platform/)).\n> - **2026-11-13:** Reddit ends RSS feed support ([changelog, October 8, 2026](https://support.reddithelp.com/hc/en-us/articles/54353370049684-Changelog-October-8-2026)). RSS was the only thing this server could read without credentials, so from this date every call without credentials returns an error saying credentials are needed.\n> - **2027-01-12:** Reddit starts closing API access for apps whose owners have not registered them at [developers.reddit.com/app-registration](https://developers.reddit.com/app-registration) or answered Reddit's outreach ([migration post](https://www.reddit.com/r/redditdev/comments/1wubcvf/moving_data_api_apps_to_the_developer_platform/)).\n> - **March 2027:** Reddit ends the remaining public API access ([migration post](https://www.reddit.com/r/redditdev/comments/1wubcvf/moving_data_api_apps_to_the_developer_platform/)).\n>\n> This project cannot grant API access or register your app for you.\n\n[![npm version](https://img.shields.io/npm/v/reddit-mcp-buddy.svg)](https://www.npmjs.com/package/reddit-mcp-buddy)\n[![npm downloads](https://img.shields.io/npm/dm/reddit-mcp-buddy.svg)](https://www.npmjs.com/package/reddit-mcp-buddy)\n[![GitHub stars](https://img.shields.io/github/stars/karanb192/reddit-mcp-buddy.svg?style=flat&logo=github&color=brightgreen)](https://github.com/karanb192/reddit-mcp-buddy/stargazers)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n\n## 🎬 See It In Action\n\n![Reddit MCP Buddy Demo - AirPods Max 2 and Dune Part Three](assets/images/reddit-mcp-buddy-demo-2026.gif)\n\n*Claude checking Reddit's reaction to the Dune Part Three trailer and whether the AirPods Max 2 are worth $549*\n\n![Reddit MCP Buddy Demo - Analyzing H1B sentiment across subreddits](assets/images/reddit-mcp-buddy.gif)\n\n*Claude analyzing real-time sentiment about H-1B visa changes across r/cscareerquestions and r/india*\n\n## Table of Contents\n\n- [What makes Reddit MCP Buddy different?](#what-makes-reddit-mcp-buddy-different)\n- [Quick Start](#quick-start-30-seconds)\n- [What can it do?](#what-can-it-do)\n- [Available Tools](#available-tools)\n- [Authentication](#authentication)\n- [Posting (v1.2.0)](#posting-v120)\n- [Installation Options](#installation-options)\n  - [Global Install](#global-install)\n  - [From Source](#from-source)\n  - [Using Docker](#using-docker)\n  - [Claude Desktop Extension](#claude-desktop-extension)\n- [Comparison with Other Tools](#comparison-with-other-tools)\n- [Troubleshooting](#troubleshooting)\n- [Development](#development)\n- [Support](#support)\n- [Related Resources](#-related-resources)\n\n## What makes Reddit MCP Buddy different?\n\n- **🔑 Built for existing API access** - Uses your approved Reddit app's credentials through Reddit's OAuth API\n- **✍️ Opt-in posting (v1.2.0)** - Create posts and comments with a client-dependent confirmation flow, per-process caps, and duplicate suppression\n- **⚡ Local rate limits** - Configured caps of 10/60/100 requests per minute; Reddit applies its own limits\n- **🎯 Clean data** - No fake \"sentiment analysis\" or made-up metrics\n- **🧠 LLM-optimized** - Built specifically for AI assistants like Claude\n- **📦 TypeScript** - Fully typed, reliable, and maintainable\n- **✅ Rate-limit testing** - Verification tools for the server's local authentication tiers\n\n## Quick Start (30 seconds)\n\n### For Claude Desktop - Desktop Extension (Easiest!)\n\n1. **Download**: [reddit-mcp-buddy.mcpb](https://github.com/karanb192/reddit-mcp-buddy/releases/latest/download/reddit-mcp-buddy.mcpb)\n2. **Install**: Open the downloaded file\n3. **Add credentials**: Enter your approved Reddit app's client ID and secret in the extension settings (see [Authentication](#authentication))\n\n### For Claude Desktop - NPM Method (Alternative)\n\nAdd this to your `claude_desktop_config.json`, with your approved app's credentials (see [Authentication](#authentication)):\n\n```json\n{\n  \"mcpServers\": {\n    \"reddit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"reddit-mcp-buddy\"],\n      \"env\": {\n        \"REDDIT_CLIENT_ID\": \"your_client_id\",\n        \"REDDIT_CLIENT_SECRET\": \"your_client_secret\"\n      }\n    }\n  }\n}\n```\n\n### For Claude Code\n\nRun this command to add the MCP server (user scope):\n\n```bash\nclaude mcp add --transport stdio reddit-mcp-buddy -s user \\\n  -e REDDIT_CLIENT_ID=your_client_id -e REDDIT_CLIENT_SECRET=your_client_secret \\\n  -- npx -y reddit-mcp-buddy\n```\n\n### For Other MCP Clients\n\nRun `npx -y reddit-mcp-buddy` with `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` set in its environment.\n\n## What can it do?\n\nAsk your AI assistant to:\n\n- 📊 **\"What's trending on Reddit?\"** - Browse hot posts from r/all\n- 🔍 **\"Search for discussions about AI\"** - Search across all subreddits\n- 💬 **\"Get comments from this Reddit post\"** - Fetch post with full comment threads\n- 👤 **\"Analyze user spez\"** - Get user history, karma, and activity\n- 🧭 **\"Which subreddits talk about home espresso?\"** - Check subreddit names and get Reddit's own suggestions\n- 📚 **\"Explain Reddit karma\"** - Understand Reddit terminology\n- ✍️ **\"Post this to r/test\"** - Draft, check the sub's rules, and submit after you confirm (opt-in, see [Posting](#posting-v120))\n\n## Available Tools\n\n### `browse_subreddit`\nBrowse posts from any subreddit with sorting options.\n```\n- Subreddit:\n  - \"all\" - entire Reddit frontpage\n  - \"popular\" - trending across Reddit\n  - Any specific subreddit (e.g., \"technology\", \"programming\", \"science\")\n- Sort by: hot, new, top, rising, controversial\n- Time range: hour, day, week, month, year, all (for top/controversial sort)\n- Include subreddit info: Optional flag for subreddit metadata (requires credentials)\n- Include NSFW: off by default; posts left out are counted in nsfw_hidden\n```\n\n> **No credentials?** Until 2026-11-13, results come from Reddit's RSS feed (`data_source: \"rss\"`): `score`, `num_comments`, `upvote_ratio`, and `nsfw` come back `null`, and the `include_nsfw` filter can't be applied. Reddit ends RSS support on 2026-11-13 ([changelog](https://support.reddithelp.com/hc/en-us/articles/54353370049684-Changelog-October-8-2026)); from then on browsing needs credentials too ([Authentication](#authentication)).\n\n### `search_reddit`\nSearch across Reddit or specific subreddits.\n```\n- Query: Your search terms\n- Filter by: subreddit, author, time, flair\n- Sort by: relevance, hot, top, new, comments\n- Include NSFW: off by default. Reddit leaves NSFW posts out before it answers, so a\n  search inside an NSFW subreddit returns nothing unless this is on\n```\n\n### `get_post_details`\nGet a post with all its comments.\n```\n- Input:\n  - Reddit URL (supports multiple formats), OR\n  - Post ID alone (will auto-detect subreddit, 2 API calls), OR\n  - Post ID + subreddit (most efficient, 1 API call)\n- Supported URL formats:\n  - reddit.com, www.reddit.com\n  - old.reddit.com, new.reddit.com\n  - np.reddit.com (No Participation links)\n  - m.reddit.com (mobile links)\n  - redd.it short URLs\n  - URLs with query params (?utm_source=...) or fragments (#comment)\n- Options: comment sorting, depth, link extraction\n```\n\n### `user_analysis`\nAnalyze a Reddit user's profile.\n```\n- Username: Any Reddit user\n- Returns: karma, posts, comments, active subreddits\n```\n\n### `find_subreddits`\nFind subreddits for a topic, and check subreddit names before using them.\n```\n- Query: 2 to 4 keywords, not a sentence (Reddit's subreddit search matches words)\n- Candidates: up to 10 subreddit names the assistant thinks fit (optional)\n- Include NSFW: off by default; subreddits left out are counted in nsfw_hidden\n- Limit: how many Reddit search suggestions to return (default 10, max 50)\n- Min subscribers: search suggestions below this are left out (default 1000);\n  candidates are never filtered by size\n- Returns: name, url, title, description, subscribers with an as-of time, NSFW flag, type,\n  source (assistant or reddit_search), and whether it was confirmed to exist\n- Candidates Reddit does not return are listed in not_found; if the name check itself\n  fails, they come back unchecked instead\n- Subreddits that exist but cannot be read (private, quarantined, banned) are listed\n  in unavailable with the reason\n- Needs credentials; at most 2 Reddit requests per call\n```\n\n### `reddit_explain`\nGet explanations of Reddit terms.\n```\n- Terms: karma, cake day, AMA, ELI5, etc.\n```\n\n### NSFW content\nNSFW posts and subreddits are left out by default. When you ask for them, the assistant can set `include_nsfw` on `browse_subreddit`, `search_reddit` or `find_subreddits` for that one call. To change the rule for the whole server, set `REDDIT_BUDDY_NSFW`:\n\n| Value | What it does |\n|-------|--------------|\n| `ask` (default) | Hidden unless a call sets `include_nsfw: true` |\n| `never` | Always hidden, whatever the assistant sends. `include_nsfw` has no effect, `get_post_details` refuses a post marked NSFW, and `user_analysis` leaves NSFW posts and comments out |\n| `always` | Included unless a call sets `include_nsfw: false` |\n\n```json\n\"env\": {\n  \"REDDIT_CLIENT_ID\": \"your_client_id\",\n  \"REDDIT_CLIENT_SECRET\": \"your_client_secret\",\n  \"REDDIT_BUDDY_NSFW\": \"never\"\n}\n```\n\n- In `ask` and `always`, `get_post_details` and `user_analysis` are not filtered: you named the post or the user.\n- Any other value is treated as `never` and logged at startup, so a typo cannot open what you meant to lock.\n- The server goes by Reddit's own NSFW mark on each post and subreddit, and on the comments in a user's history. It does not inspect content, so something Reddit has marked as not NSFW is shown.\n- Reddit puts no NSFW mark on the comments under a post, so the post's mark decides for them: `get_post_details` returns the comments of a post that is not marked NSFW as they are, on `never` too.\n- On `never`, anything Reddit has not marked either way is left out as well, and `browse_subreddit` leaves out the subreddit info of an NSFW subreddit.\n- Claude Desktop extension users: use the **NSFW content** field in the extension settings. It maps to the same variable.\n\n### Write tools (opt-in)\n\n`create_post`, `add_comment`, and `subreddit_rules` only appear when you enable posting; read-only installs see exactly the six tools above. Details in [Posting (v1.2.0)](#posting-v120).\n\n## Authentication\n\nEvery tool that reads Reddit needs credentials for a Reddit app whose API access Reddit has already approved. Only `reddit_explain`, which works offline, runs without them.\n\n### Who can use this server\n\n- **You already hold approved Reddit API access:** use your app's credentials below.\n- **You do not:** Reddit stopped accepting new requests for public API access on 2026-10-31 ([migration post](https://www.reddit.com/r/redditdev/comments/1wubcvf/moving_data_api_apps_to_the_developer_platform/)), so there is no way to get credentials for this server now. This project cannot grant access, and it does not provide shared API keys or a third-party OAuth service.\n- **Keep your access past 2027-01-12:** Reddit starts closing API access on that date for apps whose owners have not registered them at [developers.reddit.com/app-registration](https://developers.reddit.com/app-registration) or answered Reddit's outreach ([migration post](https://www.reddit.com/r/redditdev/comments/1wubcvf/moving_data_api_apps_to_the_developer_platform/)). Registration is done by each app's owner; this project cannot do it for you.\n\nWithout credentials, `browse_subreddit` reads Reddit's RSS feeds only until 2026-11-13, when Reddit ends RSS support ([changelog](https://support.reddithelp.com/hc/en-us/articles/54353370049684-Changelog-October-8-2026)). From then on every Reddit tool returns an error that says credentials are needed.\n\n### Setup Steps\n\n1. **Open** https://www.reddit.com/prefs/apps and select your approved app.\n2. **Check the app type:** **\"script\"** supports password-grant authentication, **\"web app\"** supports OAuth consent with a refresh token (see below), and app-only mode works with both.\n3. **Find your credentials:**\n   - **Client ID**: The string beneath the app's name and type\n   - **Client Secret**: The secret string\n4. **Update your Claude Desktop config:**\n\n```json\n{\n  \"mcpServers\": {\n    \"reddit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"reddit-mcp-buddy\"],\n      \"env\": {\n        \"REDDIT_CLIENT_ID\": \"your_client_id\",\n        \"REDDIT_CLIENT_SECRET\": \"your_client_secret\",\n        \"REDDIT_USERNAME\": \"your_username\",\n        \"REDDIT_PASSWORD\": \"your_password\"\n      }\n    }\n  }\n}\n```\n\n### Web apps with OAuth consent\n\nAn approved web app can authenticate a user without their Reddit password. `--oauth` runs Reddit's [authorization-code flow](https://github.com/reddit-archive/reddit/wiki/OAuth2#authorization) once and prints a refresh token.\n\n1. **Register the redirect URI.** On [Reddit app preferences](https://www.reddit.com/prefs/apps), the web app's redirect URI must be a loopback address with a port, such as `http://localhost:8080`.\n2. **Run the consent command** on the machine where your browser is signed in to Reddit:\n\n   ```bash\n   npx -y reddit-mcp-buddy --oauth\n   ```\n\n   It prompts for the web app's client ID and secret, or reads `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` from the environment. It requests `identity`, `read`, and `history`, which the read-only tools need. Add `--write` to also request `submit` and `flair` for [posting](#posting-v120). Pass `--redirect-uri http://localhost:<port>` if you registered a different port.\n3. **Open the printed link and click Allow.** Reddit redirects back to a temporary local server that only listens on your machine. It checks the random `state` value, exchanges the one-time code, and confirms the account with `/api/v1/me`. It waits up to 5 minutes and never posts.\n4. **Copy the token into your config.** It prints `REDDIT_REFRESH_TOKEN=...`. To keep it off the screen, add `--out ~/reddit-token.env`, a path outside any repository. If that file already exists, the command stops before asking for consent. If writing fails after consent, it prints the token instead. On macOS and Linux the file is readable only by you.\n\nSet these variables in the server's environment:\n\n```json\n{\n  \"REDDIT_CLIENT_ID\": \"your_client_id\",\n  \"REDDIT_CLIENT_SECRET\": \"your_client_secret\",\n  \"REDDIT_REFRESH_TOKEN\": \"your_refresh_token\"\n}\n```\n\nLeave `REDDIT_PASSWORD` unset when using a refresh token. Setting both is rejected at startup. The server exchanges the refresh token for access tokens as needed and does not write environment credentials to `auth.json`. Refresh tokens loaded from that file are not used; configure this mode through the environment.\n\nTreat a refresh token like a password. Keep it outside version control and revoke access in [Reddit app preferences](https://www.reddit.com/prefs/apps) when it is no longer needed. OAuth consent does not grant Reddit API approval or extend the approved use case.\n\n### Three-Tier Authentication System\n\nReddit MCP Buddy enforces these local caps. They are not Reddit API quotas or guaranteed throughput:\n\n| Mode | Local Cap | Required Credentials | Best For |\n|------|------------|---------------------|----------|\n| **No credentials** | 10 req/min* | None | Ends 2026-11-13 |\n| **App-Only** | 60 req/min | Client ID + Secret | Regular browsing |\n| **Authenticated** | 100 req/min | Client ID + Secret, plus refresh token or username/password | Heavy usage, automation |\n\n*\\*Until 2026-11-13 only. Requests without credentials are served from Reddit's logged-out RSS feed, which applies its own stricter per-IP throttle.*\n\n#### How It Works:\n- **No credentials**: Until 2026-11-13, only `browse_subreddit` (from Reddit's RSS feed, with engagement metrics and NSFW flags as `null`) and the offline `reddit_explain` work. After Reddit ends RSS support that day, every Reddit tool returns an error that says credentials are needed.\n- **App-Only Mode**: Uses OAuth2 client credentials grant (works with both script and web apps)\n- **Authenticated Mode**: Uses OAuth2 refresh-token authentication for an authorized web app, or password grant for a script app\n\n**Important Notes**:\n- Client credentials select app-only mode; a refresh token or username/password selects user authentication.\n- A refresh token carries the scopes granted during consent. Missing scopes can prevent individual tools from working.\n- User authentication changes this server's local cap; it does not grant a larger quota from Reddit.\n\n## Posting (v1.2.0)\n\nSince v1.2.0 the server can post for you. Three tools, all opt-in:\n\n- **`create_post`** - Submit a text or link post to one subreddit. Checks mechanical rules (title limits, flair required, link vs text allowed) and supports `validate_only: true` as a dry run. Confirmation depends on the client's capabilities as described below.\n- **`add_comment`** - Comment on a post or reply to a specific comment (by id or URL), with the same confirmation flow.\n- **`subreddit_rules`** - Read-only. Fetches a sub's rules, posting requirements, capability flags, and flair choices in one cached call, so drafts fit the sub before anything is submitted.\n\nThe intended workflow: `subreddit_rules` first, then `create_post` with `validate_only: true`, review the full draft and options with the user, then submit the identical payload.\n\n### Enabling posting\n\nAdd `REDDIT_BUDDY_WRITE` next to your existing credentials:\n\n```json\n{\n  \"mcpServers\": {\n    \"reddit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"reddit-mcp-buddy\"],\n      \"env\": {\n        \"REDDIT_CLIENT_ID\": \"your_client_id\",\n        \"REDDIT_CLIENT_SECRET\": \"your_client_secret\",\n        \"REDDIT_USERNAME\": \"your_username\",\n        \"REDDIT_PASSWORD\": \"your_password\",\n        \"REDDIT_BUDDY_WRITE\": \"true\"\n      }\n    }\n  }\n}\n```\n\nClaude Desktop extension users: flip the **Enable posting tools** toggle in the extension settings instead. It maps to the same `REDDIT_BUDDY_WRITE` variable.\n\nAlternatively, replace `REDDIT_PASSWORD` with `REDDIT_REFRESH_TOKEN` from the [web-app consent flow](#web-apps-with-oauth-consent); `npx -y reddit-mcp-buddy --oauth --write` requests the posting scopes. Posting requires the granted scopes `identity`, `read`, `submit`, and `flair`. Add `history` if you also use `user_analysis`. `REDDIT_USERNAME` is optional with a refresh token; when provided, it must match the account returned by Reddit.\n\nCredentials must come from environment variables (or extension config fields, which become environment variables). The interactive `--auth` file setup does not enable posting. Startup verifies the account through Reddit and checks granted scopes. If any requirement is missing, the server logs the reason and keeps posting tools disabled.\n\n### The safety model, in plain words\n\nPosting uses your account. The server enforces registration, rate limits, and duplicate checks; human approval also depends on the client:\n\n- **Off by default.** Without `REDDIT_BUDDY_WRITE`, the write tools do not exist: read-only installs see only the 6 read tools, and pay zero extra context.\n- **stdio only.** The HTTP transport has no authentication, so write tools refuse to register there. No process on your machine or network can turn the HTTP endpoint into a posting proxy.\n- **Confirmation depends on the client.** Clients supporting [MCP elicitation](https://modelcontextprotocol.io/specification/latest) get a confirmation prompt with the target, account, content preview, full content length, and post options. The prompt requires an explicit acceptance. Previews can be truncated, so review the full draft in your client first. Without elicitation, the server requires a preview or successful dry run followed by the identical payload within 15 minutes. It cannot verify that a human approved that repeat: approval depends on the client's tool prompt and the model following instructions. Only enable posting in a client whose approval behavior you trust.\n- **Hourly caps you cannot raise.** At most 5 posts/hour, 30 comments/hour, and 15 seconds between writes, enforced in the server. Environment variables can tighten these, never loosen them. Honest limit: the caps live in the server process (a restart resets the hour, parallel sessions have separate caps, and a fork of this open-source code can remove them). They exist to make casual abuse pointless, not to stop a determined operator.\n- **Duplicate suppression.** Retrying an identical submit within 15 minutes returns the original post instead of posting twice, including the same content re-drafted for the same sub. Posting the same content to a different subreddit is allowed, with a warning naming the earlier post.\n- **Verified after submit.** Reddit happily returns \"success\" for posts AutoModerator removes seconds later. The server re-checks after submitting and reports `status: \"filtered\"` with a warning when that happens, instead of telling you it went live.\n- **Conspicuous logging.** Every allowed write is logged to stderr with the kind, the target (subreddit when known), and the acting user.\n\n### Know the trade-off before enabling\n\nReddit's password grant returns a token with **full account scope**. An OAuth refresh token carries the permissions granted during consent. These permissions apply across the account, not just one subreddit. With posting off, the server uses the credentials for reads; enabling posting lets it submit posts and comments. Keep passwords and refresh tokens out of version control and off shared machines.\n\nAlso worth knowing: Reddit applies its own account-level posting throttles on top of everything above, based on account age and karma. If Reddit says \"try again in N minutes\", the server surfaces the wait instead of hammering.\n\n## Privacy & Data Handling\n\nReddit MCP Buddy is designed with privacy and transparency in mind. Here's how your data is handled:\n\n### Data Collection\n- **Reddit API Data**: The server fetches public Reddit content (posts, comments, user profiles) through Reddit's official API\n- **No Tracking**: We don't collect, store, or transmit any analytics, telemetry, or usage data\n- **No Third Parties**: All data flows directly between your machine, Reddit's API, and your AI assistant\n\n### Local Storage\n- **Authentication Credentials** (optional):\n  - Stored locally in `~/.reddit-mcp-buddy/auth.json` when using `--auth` CLI setup\n  - Passwords are **never** written to disk - only used in-memory for OAuth token exchange\n  - Environment variables (recommended for Claude Desktop) are never persisted by this server\n- **Cache Data**:\n  - Reddit API responses are temporarily cached in memory to improve performance\n  - Cache size limited to 50MB maximum\n  - All cache data is cleared when the server stops\n  - Can be disabled with `REDDIT_BUDDY_NO_CACHE=true`\n\n### Data Transmission\n- **Reddit API Only**: Your credentials are only sent to Reddit's official OAuth endpoints (`https://oauth.reddit.com` and `https://www.reddit.com`)\n- **No External Services**: No data is sent to any other external services, analytics platforms, or third parties\n- **Local Processing**: All data processing happens locally on your machine\n\n### Security Notes\n- **Read-Only by Default**: Posting requires explicit opt-in. Review the [client-dependent confirmation flow](#the-safety-model-in-plain-words) before enabling it.\n- **Credential Safety**:\n  - OAuth tokens are refreshed automatically and kept in memory; only `--auth` CLI setups also cache the token in `~/.reddit-mcp-buddy/auth.json` (file mode 600)\n  - Client secrets are treated as sensitive and never logged\n  - Use environment variables in Claude Desktop config for maximum security\n- **Open Source**: Full source code is available at https://github.com/karanb192/reddit-mcp-buddy for security auditing\n\n### GDPR & Privacy Compliance\n- **No Personal Data Collection**: We don't collect or process any personal data beyond what's necessary to authenticate with Reddit's API\n- **User Control**: You control all credentials and can delete `~/.reddit-mcp-buddy/auth.json` at any time\n- **Right to Erasure**: Simply delete the auth file or uninstall the server to remove all local data\n\n### Questions or Concerns?\nIf you have any privacy questions or concerns, please [open an issue](https://github.com/karanb192/reddit-mcp-buddy/issues) on GitHub.\n\n## Testing & Development\n\n### Testing Your Rate Limits\n\nReddit MCP Buddy includes comprehensive testing tools to verify your authentication is working correctly:\n\n```bash\n# Clone the repository first\ngit clone https://github.com/karanb192/reddit-mcp-buddy.git\ncd reddit-mcp-buddy\nnpm install\n\n# Test with your current environment settings\nnpm run test:rate-limit\n\n# Test specific authentication modes\nnpm run test:rate-limit:app     # Test app-only mode (60 rpm)\nnpm run test:rate-limit:auth    # Test authenticated mode (100 rpm)\n```\n\nThe rate limit tester will:\n- Start a local server instance\n- Make rapid API requests to test rate limits\n- Display a real-time progress bar\n- Confirm which authentication tier you're using\n- Show exactly when rate limiting kicks in\n\n### Interactive Authentication Setup (for local testing only)\n\nFor local development and testing, you can set up authentication interactively:\n```bash\nnpx -y reddit-mcp-buddy --auth\n```\n\nThis will prompt you for Reddit app credentials and save them locally. **Note: This does NOT work with Claude Desktop** - use environment variables in your Claude config instead.\n\n### Private sandbox posting test\n\nBuild the checkout, then print the proposed test without making any requests:\n\n```bash\nnpm run build\nREDDIT_TEST_SUBREDDIT=your_private_sub node tests/live-write.mjs\n```\n\nThe live run requires an approved app, `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET`, plus either `REDDIT_REFRESH_TOKEN` or the script-app `REDDIT_USERNAME`/`REDDIT_PASSWORD` pair. The account must moderate the private test subreddit. OAuth validation requires all six scopes: `identity`, `read`, `submit`, `flair`, `history` for recovery, and `edit` for cleanup. The harness checks these before connecting any posting client. Keep credentials outside the repository. On Node versions supporting `--env-file`, a local environment file can supply them:\n\n```bash\nRUN_WRITE_TESTS=1 REDDIT_TEST_SUBREDDIT=your_private_sub \\\n  node --env-file=/path/to/private.env tests/live-write.mjs --run\n```\n\nThis command performs real writes. It starts actual stdio MCP connections, declines one post request, accepts one test post, and tests comment preview followed by an identical submission from a client without elicitation. The harness supplies the confirmation responses automatically; running it authorizes these test actions. It creates one post and one comment, verifies their content, then attempts deletion of both even after a failure.\n\nThe unique marker and any cleanup failures are printed for manual inspection. Lost responses trigger a search of the test user's newest posts and comments; an unresolved outcome or unverified deletion fails the run. Cleanup cannot be guaranteed if the process is killed or Reddit is unavailable. Ordinary unit tests use an offline API fixture, and normal integration runs skip posting unless explicitly enabled.\n\n### Testing with HTTP Mode\n\nTo test the server directly in your terminal:\n```bash\n# Run in HTTP mode on port 3000\nnpx -y reddit-mcp-buddy --http\n\n# Or with custom port\nREDDIT_BUDDY_PORT=8080 npx -y reddit-mcp-buddy --http\n```\n\n**Note:** The server runs in stdio mode by default (for Claude Desktop). Use `--http` flag for testing with Postman MCP or direct API calls.\n\n## Installation Options\n\n### Global Install\n```bash\nnpm install -g reddit-mcp-buddy\nreddit-buddy --http  # For testing\n```\n\n### From Source\n```bash\ngit clone https://github.com/karanb192/reddit-mcp-buddy.git\ncd reddit-mcp-buddy\nnpm install\nnpm run build\nnpm link\n```\n\n### Using Docker\n\nThe Docker image and CI workflows use Node.js 26. To build and run the image:\n\n```bash\ngit clone https://github.com/karanb192/reddit-mcp-buddy.git\ncd reddit-mcp-buddy\ndocker build --pull -t reddit-mcp-buddy .\ndocker run -it -e REDDIT_CLIENT_ID=your_client_id -e REDDIT_CLIENT_SECRET=your_client_secret reddit-mcp-buddy\n```\n\nRun the container smoke test with Docker, curl, and jq installed:\n\n```bash\nbash tests/test-docker.sh reddit-mcp-buddy\n```\n\nThe test checks container health, MCP initialization, tool discovery, and shutdown without Reddit credentials.\n\n### Claude Desktop Extension\n\nFor one-click installation in Claude Desktop, download the pre-built extension:\n\n**📦 [Download reddit-mcp-buddy.mcpb](https://github.com/karanb192/reddit-mcp-buddy/releases/latest/download/reddit-mcp-buddy.mcpb)**\n\n**Installation:** Open the downloaded `.mcpb` file and Claude Desktop installs the extension. Then enter your approved Reddit app's credentials in the extension settings (see [Authentication](#authentication)).\n\n#### Build from Source (Optional)\n\nIf you prefer to build the extension yourself:\n```bash\ngit clone https://github.com/karanb192/reddit-mcp-buddy.git\ncd reddit-mcp-buddy\n./scripts/build-mcpb.sh\n```\n\n**Note**: Most users should use the standard npm installation method shown in [Quick Start](#quick-start-30-seconds).\n\n## Comparison with Other Tools\n\n| Feature | Reddit MCP Buddy | Other MCP Tools |\n|---------|-------------|----------------|\n| **Credentials** | Existing approved Reddit API access required | Varies by server |\n| **Language** | TypeScript/Node.js | Python (most) |\n| **Tools Count** | 6 read + 3 opt-in write | 8-10 (redundant) |\n| **Fake Metrics** | ✅ Real data only | ❌ \"Sentiment scores\" |\n| **Search** | ✅ Full search | Limited or none |\n| **Caching** | ✅ Smart caching | Usually none |\n| **LLM Optimized** | ✅ Clear params | Confusing options |\n| **Rate Limit Testing** | ✅ Built-in tools | ❌ No verification |\n\n## Rate Limits\n\n| Mode | Requests/Minute | Cache TTL | Setup Required |\n|------|----------------|-----------|----------------|\n| No credentials (until 2026-11-13) | 10 | 15 min | None |\n| App-only | 60 | 5 min | Client ID + Secret |\n| Authenticated | 100 | 5 min | All credentials |\n\n*Cache TTL applies to subreddit listings. Post details (10 min), search results (10 min), and user profiles (15 min) use fixed TTLs in all modes.*\n\n## Why Reddit MCP Buddy?\n\n### What others do wrong:\n- ❌ **Fake metrics** - \"sentiment scores\" that are just keyword counting\n- ❌ **Bloated responses** - Returning 100+ fields of Reddit's raw API\n- ❌ **Poor LLM integration** - Confusing parameters and unclear descriptions\n\n### What we do right:\n- ✅ **Real data only** - If it's not from Reddit's API, we don't make it up\n- ✅ **Clean responses** - Only the fields that matter\n- ✅ **Clear parameters** - LLMs understand exactly what to send\n- ✅ **Fast & cached** - Responses are instant when possible\n\n## Examples\n\n### Your AI can now answer:\n\n**\"What are the top posts about GPT-4 today?\"**\n```\n→ search_reddit with query=\"GPT-4\", time=\"day\", sort=\"top\"\n```\n\n**\"Show me what's trending in technology\"**\n```\n→ browse_subreddit with subreddit=\"technology\", sort=\"hot\"\n```\n\n**\"What do people think about this article?\"**\n```\n→ search_reddit with the article URL to find discussions\n```\n\n**\"Analyze the user DeepFuckingValue\"**\n```\n→ user_analysis with username=\"DeepFuckingValue\"\n```\n\n**\"Where do people discuss home espresso machines?\"**\n```\n→ find_subreddits with query=\"home espresso\", candidates=[\"espresso\", \"Coffee\"]\n```\n\n**\"Get the comments from this Reddit post\"**\n```\n→ get_post_details with url=\"https://reddit.com/r/...\"\n```\n\n**\"What's trending across all of Reddit?\"**\n```\n→ browse_subreddit with subreddit=\"all\", sort=\"hot\"\n```\n\n## Troubleshooting\n\n### Common Issues\n\n**\"Reddit ended logged-out RSS access on 2026-11-13\"**\n- The server has no credentials, and Reddit no longer serves the RSS feeds it used without them ([changelog](https://support.reddithelp.com/hc/en-us/articles/54353370049684-Changelog-October-8-2026)). The subreddit, post, or user you asked for is not the problem\n- Add your approved app's credentials (see [Authentication](#authentication)). Reddit stopped accepting new API access requests on 2026-10-31, so this only helps people who already hold access\n\n**\"Cannot create an app\" or \"API approval required\"**\n- Reddit stopped accepting new requests for public API access on 2026-10-31 ([migration post](https://www.reddit.com/r/redditdev/comments/1wubcvf/moving_data_api_apps_to_the_developer_platform/)); this project cannot approve an app or remove Reddit's restrictions\n- Use credentials only for an app and use case Reddit has approved\n\n**\"Can't achieve 100 requests/minute\"**\n- The 10/60/100 tiers are this server's local caps, not guaranteed throughput from Reddit\n- Respect Reddit's rate-limit responses; adding account credentials does not increase Reddit's granted quota\n- Run `npm run test:rate-limit:app` or `npm run test:rate-limit:auth` to inspect the corresponding local mode (requires cloning the repo)\n\n**\"Command not found\" error**\n```bash\n# Ensure npm is installed\nnode --version\nnpm --version\n\n# Try the full global-bin path\n$(npm prefix -g)/bin/reddit-mcp-buddy\n```\n\n**Browsing works but search / comments / user analysis fail**\n- Without credentials, only `browse_subreddit` (from Reddit's RSS feed, until 2026-11-13) and the offline `reddit_explain` work\n- Solution: Add your approved app's credentials (see [Authentication](#authentication))\n\n**Rate limit errors**\n- Local caps: 60 requests/minute with app credentials and 100 with full authentication (10 without credentials, until 2026-11-13)\n- Reddit applies its own API limits; the server retries transient failures, but sustained throttling can still fail\n- Reduce request frequency and respect Reddit's rate-limit responses\n- If an error says `Retry in Ns`, wait that long before retrying. The server returns long upstream waits immediately instead of sleeping through the client's request timeout.\n\n**Write tools don't show up**\n- All of these must hold: `REDDIT_BUDDY_WRITE=true`, client credentials plus a refresh token or username/password via environment variables, stdio transport, a verified user identity, and granted `identity`/`read`/`submit`/`flair` scopes\n- The startup log (stderr) names exactly which condition failed\n- `--auth` file setups cannot write: the password is never saved, so restarts fall back to app-only tokens. Move credentials into your MCP client config's `env` block\n- HTTP mode never registers write tools, by design (the HTTP endpoint has no authentication)\n\n**\"Subreddit not found\"**\n- Check spelling (case-insensitive)\n- Some subreddits may be private or quarantined\n- Try \"all\" or \"popular\" instead\n\n**Connection issues**\n- Reddit may be down (check https://www.redditstatus.com)\n- Firewall blocking requests\n- Try restarting the MCP server\n\n### Environment Variables\n\n#### Authentication Variables\n| Variable | Description | Required | Rate Limit |\n|----------|-------------|----------|------------|\n| `REDDIT_CLIENT_ID` | Reddit app client ID | Yes (from 2026-11-13) | Local cap: 60 req/min (with secret) |\n| `REDDIT_CLIENT_SECRET` | Reddit app secret | Yes (from 2026-11-13) | Local cap: 60 req/min (with ID) |\n| `REDDIT_USERNAME` | Reddit account username | No | Local cap: 100 req/min (with all 4) |\n| `REDDIT_PASSWORD` | Reddit account password | No | Local cap: 100 req/min (with all 4) |\n| `REDDIT_REFRESH_TOKEN` | OAuth refresh token; leave password unset | No | Local cap: 100 req/min with client ID + secret |\n| `REDDIT_USER_AGENT` | Custom user agent string (applies when credentials are configured) | No | - |\n\n#### Server Configuration\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `REDDIT_BUDDY_HTTP` | Run as HTTP server instead of stdio | `false` |\n| `REDDIT_BUDDY_PORT` | HTTP server port (when HTTP=true) | `3000` |\n| `REDDIT_BUDDY_HOST` | Interface the HTTP server binds to | `127.0.0.1` |\n| `REDDIT_BUDDY_ALLOWED_ORIGINS` | Comma-separated browser origins allowed to call the HTTP endpoint | none |\n| `REDDIT_BUDDY_ALLOWED_HOSTS` | Comma-separated `host:port` values accepted in the Host header (DNS-rebinding protection) | loopback values when bound to localhost |\n| `REDDIT_BUDDY_NO_CACHE` | Disable caching (always fetch fresh) | `false` |\n| `REDDIT_BUDDY_NSFW` | [NSFW content](#nsfw-content): `ask` (hidden unless a call asks), `never` (always hidden) or `always` (included by default) | `ask` |\n\n#### Posting (v1.2.0)\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `REDDIT_BUDDY_WRITE` | Register the [posting tools](#posting-v120); requires env user credentials, verified identity and scopes, and stdio | `false` |\n| `REDDIT_BUDDY_MAX_POSTS_PER_HOUR` | Posts per hour; only values from 1 to 4 are honored (0 and invalid values are ignored) | `5` |\n| `REDDIT_BUDDY_MAX_COMMENTS_PER_HOUR` | Comments per hour; only values from 1 to 29 are honored (0 and invalid values are ignored) | `30` |\n| `REDDIT_BUDDY_MIN_WRITE_INTERVAL_S` | Seconds between writes; only values ABOVE 15 are honored | `15` |\n\nThe three rate-floor variables can only tighten the built-in caps. Setting them looser than the defaults does nothing, on purpose, and 0 does not mean \"pause posting\": it falls back to the default cap.\n\n> **HTTP mode has no authentication.** It binds to localhost so only your machine can reach it, and rejects Host headers outside the loopback set. Setting `REDDIT_BUDDY_HOST=0.0.0.0` exposes it to your whole network - only do that on a trusted network (e.g. inside Docker, which sets it deliberately). On a non-loopback bind the Host check is off by default, since clients legitimately arrive with a container IP or service name; set `REDDIT_BUDDY_ALLOWED_HOSTS` to restrict it. Browser requests are rejected unless their origin is listed in `REDDIT_BUDDY_ALLOWED_ORIGINS`; non-browser clients like Postman are unaffected.\n\n### HTTP and HTTPS Proxies\n\nOn Node 22.21.0+ in the 22.x line, or Node 24 and newer, enable Node's built-in proxy support before starting the server. The project's Node 26 Docker image supports this. Check `node --version` first: unsupported versions can ignore these settings and connect directly. Node currently marks this feature as under active development.\n\n```json\n{\n  \"mcpServers\": {\n    \"reddit\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"reddit-mcp-buddy\"],\n      \"env\": {\n        \"NODE_USE_ENV_PROXY\": \"1\",\n        \"HTTP_PROXY\": \"http://proxy.example.com:8080\",\n        \"HTTPS_PROXY\": \"http://proxy.example.com:8080\",\n        \"NO_PROXY\": \"localhost,127.0.0.1\"\n      }\n    }\n  }\n}\n```\n\n`HTTP_PROXY` routes HTTP requests; `HTTPS_PROXY` routes HTTPS requests, including Reddit API and RSS calls. `NO_PROXY` excludes matching hosts. Export these variables in your shell for CLI use, or pass them with Docker's `-e` options. Set them in the process environment before startup; the server does not load a project `.env` file automatically.\n\nInside Docker, `localhost` refers to the container. On Docker Desktop, use `host.docker.internal` to reach a proxy running on the host.\n\nProxy authentication can be included in the proxy URL as `http://username:password@proxy.example.com:8080`. Treat that value as a credential and redact it from shared logs and configuration. For a network that uses a private certificate authority, use `NODE_EXTRA_CA_CERTS` with your organization's PEM certificate file instead of disabling TLS verification.\n\nSee [Node's proxy and certificate configuration guide](https://nodejs.org/learn/http/enterprise-network-configuration). Proxy support routes network traffic; it does not grant Reddit API approval or bypass Reddit's access rules.\n\n## Technical Details\n\n### Smart Caching System\n\nReddit MCP Buddy includes intelligent caching to improve performance and reduce API calls:\n\n- **Memory Safe**: Hard limit of 50MB - won't affect your system performance\n- **Per-Content TTLs**: Post details (10min), user profiles (15min), search results (10min); subreddit listings use the mode default (5min with credentials)\n- **LRU Eviction**: Automatically removes least-used data when approaching limits\n- **Hit Tracking**: Optimizes cache based on actual usage patterns\n\nThis means faster responses and staying well within Reddit's rate limits, all while using minimal system resources.\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Run in development\nnpm run dev\n\n# Build\nnpm run build\n\n# Run tests\nnpm test                     # Unit tests\nnpm run test:integration     # Integration tests\nnpm run test:all             # All tests\n\n# Test rate limits\nnpm run test:rate-limit       # Test with current environment\nnpm run test:rate-limit:app   # Test app-only mode (60 rpm)\nnpm run test:rate-limit:auth  # Test authenticated mode (100 rpm)\n\n# Type check\nnpm run typecheck\n```\n\n### Requirements\n- Node.js >= 20.0.0\n- npm or yarn\n- TypeScript 5.5+\n\n## Contributing\n\nPRs welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\nWe keep things simple:\n- No fake analytics\n- Clean, typed code\n- Clear documentation\n- Fast responses\n\n## Support\n\n- 🐛 [Report bugs](https://github.com/karanb192/reddit-mcp-buddy/issues)\n- 💡 [Request features](https://github.com/karanb192/reddit-mcp-buddy/issues)\n- ⭐ [Star on GitHub](https://github.com/karanb192/reddit-mcp-buddy)\n\n## 🔗 Related Resources\n\n### Official MCP Resources\n- **[MCP Registry](https://registry.modelcontextprotocol.io)** - Official registry of MCP servers\n- **[MCP Specification](https://modelcontextprotocol.io/specification/latest)** - Official Model Context Protocol specification\n- **[MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)** - SDK used to build this server\n- **[MCP Servers Repository](https://github.com/modelcontextprotocol/servers)** - Collection of official MCP server implementations\n- **[Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers)** - Community-curated list of MCP servers\n\n### Where to Find This Server\n- **[MCP Registry API Link](https://registry.modelcontextprotocol.io/v0/servers?search=reddit-mcp-buddy)** - Direct API query for this server\n- **[MCP Registry Search](https://registry.modelcontextprotocol.io)** - Search for \"reddit\" to find all versions\n- **[NPM Package](https://www.npmjs.com/package/reddit-mcp-buddy)** - Install via npm/npx\n- **[GitHub Repository](https://github.com/karanb192/reddit-mcp-buddy)** - Source code and issues\n\n#### View All Versions via API\n```bash\n# Get all versions of reddit-mcp-buddy from the registry\ncurl -s \"https://registry.modelcontextprotocol.io/v0/servers?search=reddit-mcp-buddy\" | jq\n\n# Get just names, version numbers, and latest flag\ncurl -s \"https://registry.modelcontextprotocol.io/v0/servers?search=reddit-mcp-buddy\" | \\\n  jq '.servers[] | {name: .server.name, version: .server.version, isLatest: ._meta.\"io.modelcontextprotocol.registry/official\".isLatest}'\n```\n\n## License\n\nMIT - Use it however you want!\n\n---\n\nMade with ❤️ for the MCP community. No venture capital, no tracking, just a good MCP server.\n\nBuilt by [Karan Bansal](https://karanbansal.in) (Head of AI at ArmorCode). I write about Claude Code, MCP, and production agentic AI at [karanbansal.in/blog](https://karanbansal.in/blog/).\n","readmeFilename":"README.md"}