{"_id":"@daanrongen/reddit-mcp","_rev":"7-8cf2a8be7f85664b449e918629ce92c9","name":"@daanrongen/reddit-mcp","dist-tags":{"latest":"1.2.3"},"versions":{"1.0.0":{"name":"@daanrongen/reddit-mcp","version":"1.0.0","keywords":["mcp","reddit","model-context-protocol","effect"],"license":"MIT","_id":"@daanrongen/reddit-mcp@1.0.0","maintainers":[{"name":"daanrongen","email":"hi@daan.website"}],"homepage":"https://github.com/daanrongen/reddit-mcp#readme","bugs":{"url":"https://github.com/daanrongen/reddit-mcp/issues"},"bin":{"reddit-mcp":"dist/main.js"},"dist":{"shasum":"3384b948edc54dee39a7903872d827ce74ac490d","tarball":"https://registry.npmjs.org/@daanrongen/reddit-mcp/-/reddit-mcp-1.0.0.tgz","fileCount":3,"integrity":"sha512-o2zni0Ii6Dsr43ZJ1erGe4xX278zWNnDtdQA+h2b3S7ElJH2RxfFBE2gPjN+zi6fnjcZTbxp6vLJxuxuxpRLBA==","signatures":[{"sig":"MEYCIQCntUONIfTZXEAnJbePWmO0c2fCcGIOIlXxtPjHISSSvgIhALcw0Tyvb60dNUEBdJHQ+TDaGq3YEQBcJuUmANOVnODy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1197580},"main":"./dist/main.js","type":"module","engines":{"bun":">=1.0.0"},"gitHead":"d844e86060bbf5d564955795d8f1b054478d9cf9","scripts":{"dev":"bun --watch src/main.ts","lint":"biome check .","test":"bun test","build":"bun build src/main.ts --outfile dist/main.js --target bun","start":"bun run src/main.ts","format":"biome format --write .","inspect":"DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun dist/main.js","typecheck":"tsc -p tsconfig.check.json","postversion":"git push --follow-tags","release:major":"npm version major","release:minor":"npm version minor","release:patch":"npm version patch"},"_npmUser":{"name":"daanrongen","email":"hi@daan.website"},"repository":{"url":"git+https://github.com/daanrongen/reddit-mcp.git","type":"git"},"_npmVersion":"11.11.0","description":"MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^3.24.1","effect":"^3.13.0","@modelcontextprotocol/sdk":"^1.10.2"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^2.1.4","bun-types":"latest","typescript":"^5.8.3","@biomejs/biome":"^2.4.8"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp_1.0.0_1774265400692_0.48106216047856765","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@daanrongen/reddit-mcp","version":"1.0.1","keywords":["mcp","reddit","model-context-protocol","effect"],"license":"MIT","_id":"@daanrongen/reddit-mcp@1.0.1","maintainers":[{"name":"daanrongen","email":"hi@daan.website"}],"homepage":"https://github.com/daanrongen/reddit-mcp#readme","bugs":{"url":"https://github.com/daanrongen/reddit-mcp/issues"},"bin":{"reddit-mcp":"dist/main.js"},"dist":{"shasum":"b9935853a0f76addd97945c72333d7d4f2bdba3f","tarball":"https://registry.npmjs.org/@daanrongen/reddit-mcp/-/reddit-mcp-1.0.1.tgz","fileCount":3,"integrity":"sha512-9314pgOxcknUIFfIhPwRxLXNdeAV7gtX3b2sJ7ek1IE3mAMjGJ0hdwpFDwBZuRgbEEAnvZ6dZjU6Wzhhu3PqDw==","signatures":[{"sig":"MEQCIDwui0LiMUH2PrdAncA44yhe1HbegSBsezIJiI6ckJQ2AiB9TCCLvmaYpVKVebKmdbJ16xkOxWF7CIvd72yflRDgcg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1198634},"main":"./dist/main.js","type":"module","_from":"file:daanrongen-reddit-mcp-1.0.1.tgz","engines":{"bun":">=1.0.0"},"scripts":{"dev":"bun --watch src/main.ts","lint":"biome check .","test":"bun test","build":"bun build src/main.ts --outfile dist/main.js --target bun","format":"biome format --write .","inspect":"DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun dist/main.js","typecheck":"tsc -p tsconfig.check.json","postversion":"git push --follow-tags","release:major":"npm version major","release:minor":"npm version minor","release:patch":"npm version patch"},"_npmUser":{"name":"daanrongen","email":"hi@daan.website"},"_resolved":"/private/tmp/mcp-publish/daanrongen-reddit-mcp-1.0.1.tgz","_integrity":"sha512-9314pgOxcknUIFfIhPwRxLXNdeAV7gtX3b2sJ7ek1IE3mAMjGJ0hdwpFDwBZuRgbEEAnvZ6dZjU6Wzhhu3PqDw==","repository":{"url":"git+https://github.com/daanrongen/reddit-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.24.1","effect":"^3.21.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^2.1.5","bun-types":"latest","typescript":"^5.8.3","@biomejs/biome":"^2.4.12"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp_1.0.1_1776260997092_0.257697983840522","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@daanrongen/reddit-mcp","version":"1.0.2","keywords":["mcp","reddit","model-context-protocol","effect"],"license":"MIT","_id":"@daanrongen/reddit-mcp@1.0.2","maintainers":[{"name":"daanrongen","email":"hi@daan.website"}],"homepage":"https://github.com/daanrongen/reddit-mcp#readme","bugs":{"url":"https://github.com/daanrongen/reddit-mcp/issues"},"bin":{"reddit-mcp":"dist/main.js"},"dist":{"shasum":"a3c01d26de846acfc25890e058e5c1056d1c400a","tarball":"https://registry.npmjs.org/@daanrongen/reddit-mcp/-/reddit-mcp-1.0.2.tgz","fileCount":3,"integrity":"sha512-gkt+LBUxsNQX1uIdki2wQ/bTOvfjQKGLH9bHOACG2wOoh+kTf4z3vhdQNyU1qqmWBdc6X96aXxvObhbDh1yYjg==","signatures":[{"sig":"MEUCIHCkZMbqR1IuLsp4CMxRgHJYSzncIo1CD1oAEFw6OWsoAiEAv3RYMw0EU+TXSJEUSvGyXfnApCpcAWfLMgnL+AWH3bw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1198633},"main":"./dist/main.js","type":"module","engines":{"bun":">=1.0.0"},"gitHead":"6a5ba47b0e26323ff0fc77267312728691e5dd49","scripts":{"dev":"bun --watch src/main.ts","lint":"biome check .","test":"bun test","build":"bun build src/main.ts --outfile dist/main.js --target bun","format":"biome format --write .","inspect":"DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun src/main.ts","typecheck":"tsc -p tsconfig.check.json","postversion":"git push --follow-tags","release:major":"npm version major","release:minor":"npm version minor","release:patch":"npm version patch"},"_npmUser":{"name":"daanrongen","email":"hi@daan.website"},"repository":{"url":"git+https://github.com/daanrongen/reddit-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.24.1","effect":"^3.21.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^2.1.5","bun-types":"latest","typescript":"^5.8.3","@biomejs/biome":"^2.4.12"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp_1.0.2_1776263934230_0.189158479911266","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@daanrongen/reddit-mcp","version":"1.1.0","keywords":["mcp","reddit","model-context-protocol","effect"],"license":"MIT","_id":"@daanrongen/reddit-mcp@1.1.0","maintainers":[{"name":"daanrongen","email":"hi@daan.website"}],"homepage":"https://github.com/daanrongen/reddit-mcp#readme","bugs":{"url":"https://github.com/daanrongen/reddit-mcp/issues"},"bin":{"reddit-mcp":"dist/main.js"},"dist":{"shasum":"be0c758569390b98bd290637994cbdee6798abd8","tarball":"https://registry.npmjs.org/@daanrongen/reddit-mcp/-/reddit-mcp-1.1.0.tgz","fileCount":3,"integrity":"sha512-Pb2yL9sUoNxgNIBuTNNez6T58Pu7cp14Z85QOLdcqd8F63RswkSarp8Q/GNdHVjBonlmcVAQ00hdA49/TOoMyw==","signatures":[{"sig":"MEQCIE5OUT9N4oNXbcc2rCKhJJduq3R+dgbgy/AKlHQyVn4YAiAkVETFNGGBFs8dspv3iUrWVE4+2Btzi9ZUa82+UCirOA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1196344},"main":"./dist/main.js","type":"module","engines":{"bun":">=1.0.0"},"gitHead":"aa9a1b6b88ad81b1a72df98ee30f7126cf75b572","scripts":{"dev":"bun --watch src/main.ts","lint":"biome check .","test":"bun test","build":"bun build src/main.ts --outfile dist/main.js --target bun","format":"biome format --write .","inspect":"DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun src/main.ts","typecheck":"tsc -p tsconfig.check.json","postversion":"git push --follow-tags","release:major":"npm version major","release:minor":"npm version minor","release:patch":"npm version patch"},"_npmUser":{"name":"daanrongen","email":"hi@daan.website"},"repository":{"url":"git+https://github.com/daanrongen/reddit-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.24.1","effect":"^3.21.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^2.1.5","bun-types":"latest","typescript":"^5.8.3","@biomejs/biome":"^2.4.12"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp_1.1.0_1776293754902_0.8478069861720796","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@daanrongen/reddit-mcp","version":"1.2.0","keywords":["mcp","reddit","model-context-protocol","effect"],"license":"MIT","_id":"@daanrongen/reddit-mcp@1.2.0","maintainers":[{"name":"daanrongen","email":"hi@daan.website"}],"homepage":"https://github.com/daanrongen/reddit-mcp#readme","bugs":{"url":"https://github.com/daanrongen/reddit-mcp/issues"},"bin":{"reddit-mcp":"dist/main.js"},"dist":{"shasum":"4ad3f009576ab31ac1afc2256b759c335f5ae637","tarball":"https://registry.npmjs.org/@daanrongen/reddit-mcp/-/reddit-mcp-1.2.0.tgz","fileCount":3,"integrity":"sha512-UKAoy+kXOyK/CWTvNV8RCgFXCQ7AvpO+fyuRMnX78UEXT+59lHoTYD+JKzT/7n7OWpZpLooLhLrrStPKY4hU7Q==","signatures":[{"sig":"MEYCIQC0m02GVStenM5LP3yugD2qzpxw7x+JjzV2BgCzNwR1dgIhAM8fFyTrtU+m+iTaxNnvYjCiHkzWuMO4HLKIPMBjwA3d","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":1196341},"main":"./dist/main.js","type":"module","engines":{"bun":">=1.0.0"},"gitHead":"66b2a182290538515420f37e2fd7b56b8e4b3740","scripts":{"dev":"bun --watch src/main.ts","lint":"biome check .","test":"bun test","build":"bun build src/main.ts --outfile dist/main.js --target bun","format":"biome format --write .","inspect":"DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun src/main.ts","typecheck":"tsc -p tsconfig.check.json","postversion":"git push --follow-tags","release:major":"npm version major","release:minor":"npm version minor","release:patch":"npm version patch"},"_npmUser":{"name":"daanrongen","email":"hi@daan.website"},"repository":{"url":"git+https://github.com/daanrongen/reddit-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^3.24.1","effect":"^3.21.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^2.1.5","bun-types":"latest","typescript":"^5.8.3","@biomejs/biome":"^2.4.12"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp_1.2.0_1776443755011_0.41388166691339534","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@daanrongen/reddit-mcp","version":"1.2.1","keywords":["mcp","reddit","model-context-protocol","effect"],"license":"MIT","_id":"@daanrongen/reddit-mcp@1.2.1","maintainers":[{"name":"daanrongen","email":"hi@daan.website"}],"homepage":"https://github.com/daanrongen/reddit-mcp#readme","bugs":{"url":"https://github.com/daanrongen/reddit-mcp/issues"},"bin":{"reddit-mcp":"dist/main.js"},"dist":{"shasum":"01f29faa89a3c4bbd2c915f1c510dbb9eb19bbad","tarball":"https://registry.npmjs.org/@daanrongen/reddit-mcp/-/reddit-mcp-1.2.1.tgz","fileCount":3,"integrity":"sha512-qBh2Lx4p5KuSLbTS6RK+kI7Vnr6RssNPEQfGJsRTy3QDg4gAF0p/TbWTEcfGvVg2AY4N15b3K5fRSGNs0hmVpQ==","signatures":[{"sig":"MEQCICRStJnUw+QI3ZNwLT91jMyyRgFxK7bkumZUfS/le6kuAiBDY02EPja4fCiJZHEz0T+VSR7mSnFaligP+Y9lLpql3A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@daanrongen%2freddit-mcp@1.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":1196341},"main":"./dist/main.js","type":"module","_from":"file:daanrongen-reddit-mcp-1.2.1.tgz","engines":{"bun":">=1.0.0"},"scripts":{"dev":"bun --watch src/main.ts","lint":"biome check .","test":"bun test","build":"bun build src/main.ts --outfile dist/main.js --target bun","format":"biome format --write .","inspect":"DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun src/main.ts","typecheck":"tsc -p tsconfig.check.json","postversion":"git push --follow-tags","release:major":"npm version major","release:minor":"npm version minor","release:patch":"npm version patch"},"_npmUser":{"name":"daanrongen","email":"hi@daan.website"},"_resolved":"/home/runner/work/reddit-mcp/reddit-mcp/daanrongen-reddit-mcp-1.2.1.tgz","_integrity":"sha512-qBh2Lx4p5KuSLbTS6RK+kI7Vnr6RssNPEQfGJsRTy3QDg4gAF0p/TbWTEcfGvVg2AY4N15b3K5fRSGNs0hmVpQ==","repository":{"url":"git+https://github.com/daanrongen/reddit-mcp.git","type":"git"},"_npmVersion":"10.9.7","description":"MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio","directories":{},"_nodeVersion":"22.22.2","dependencies":{"zod":"^3.24.1","effect":"^3.21.0","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"lefthook":"^2.1.5","bun-types":"latest","typescript":"^5.8.3","@biomejs/biome":"^2.4.12"},"_npmOperationalInternal":{"tmp":"tmp/reddit-mcp_1.2.1_1776718442499_0.9863888968586021","host":"s3://npm-registry-packages-npm-production"}},"1.2.3":{"name":"@daanrongen/reddit-mcp","version":"1.2.3","description":"MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio","type":"module","bin":{"reddit-mcp":"dist/main.js"},"main":"./dist/main.js","scripts":{"dev":"bun --watch src/main.ts","inspect":"DANGEROUSLY_OMIT_AUTH=true mcp-inspector bun src/main.ts","build":"bun build src/main.ts --outfile dist/main.js --target bun","typecheck":"tsc -p tsconfig.check.json","test":"bun test","lint":"biome check .","format":"biome format --write .","release:patch":"npm version patch","release:minor":"npm version minor","release:major":"npm version major","postversion":"git push --follow-tags"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/daanrongen/reddit-mcp.git"},"keywords":["mcp","reddit","model-context-protocol","effect"],"engines":{"bun":">=1.0.0"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","effect":"^3.21.0","zod":"^3.24.1"},"devDependencies":{"@biomejs/biome":"^2.4.12","bun-types":"latest","lefthook":"^2.1.5","typescript":"^5.8.3"},"_id":"@daanrongen/reddit-mcp@1.2.3","bugs":{"url":"https://github.com/daanrongen/reddit-mcp/issues"},"homepage":"https://github.com/daanrongen/reddit-mcp#readme","_integrity":"sha512-lyVs1GNIMMspG/OtzE2/q7kLQb27/+wEsD+qaU4jMOF2pU8ZEJTEAhCGvi/rbbHwKkihppHQDlBic72dizRQ2A==","_resolved":"/home/runner/work/reddit-mcp/reddit-mcp/daanrongen-reddit-mcp-1.2.3.tgz","_from":"file:daanrongen-reddit-mcp-1.2.3.tgz","_nodeVersion":"22.22.2","_npmVersion":"10.9.7","dist":{"integrity":"sha512-lyVs1GNIMMspG/OtzE2/q7kLQb27/+wEsD+qaU4jMOF2pU8ZEJTEAhCGvi/rbbHwKkihppHQDlBic72dizRQ2A==","shasum":"f5b062f7e9edda0625a37130f6b1ee40c724b9f9","tarball":"https://registry.npmjs.org/@daanrongen/reddit-mcp/-/reddit-mcp-1.2.3.tgz","fileCount":3,"unpackedSize":1196341,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@daanrongen%2freddit-mcp@1.2.3","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCICdnv1j/b+6+w3P05lND6h02May0Yab/xFIs/klh2tZuAiBP0Fe4UGbiz7wqRWF4bqZJlQEctAMb1mYbrOJWXDqNGg=="}]},"_npmUser":{"name":"daanrongen","email":"hi@daan.website"},"directories":{},"maintainers":[{"name":"daanrongen","email":"hi@daan.website"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/reddit-mcp_1.2.3_1776719209610_0.36444439878875867"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-23T11:30:00.581Z","modified":"2026-04-20T21:06:50.123Z","1.0.0":"2026-03-23T11:30:00.854Z","1.0.1":"2026-04-15T13:49:57.233Z","1.0.2":"2026-04-15T14:38:54.372Z","1.1.0":"2026-04-15T22:55:55.068Z","1.2.0":"2026-04-17T16:35:55.179Z","1.2.1":"2026-04-20T20:54:02.650Z","1.2.3":"2026-04-20T21:06:49.815Z"},"bugs":{"url":"https://github.com/daanrongen/reddit-mcp/issues"},"license":"MIT","homepage":"https://github.com/daanrongen/reddit-mcp#readme","keywords":["mcp","reddit","model-context-protocol","effect"],"repository":{"type":"git","url":"git+https://github.com/daanrongen/reddit-mcp.git"},"description":"MCP server for Reddit — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio","maintainers":[{"name":"daanrongen","email":"hi@daan.website"}],"readme":"# reddit-mcp\n\nMCP server for [Reddit](https://www.reddit.com/) — search posts, browse subreddits, read comments, and write with OAuth2 user auth over stdio.\n\n## Installation\n\n```bash\nbunx @daanrongen/reddit-mcp\n```\n\n## Tools\n\n| Domain     | Tools                                                                   | Coverage                                   |\n| ---------- | ----------------------------------------------------------------------- | ------------------------------------------ |\n| **Search** | `search_posts`, `search_subreddits`                                     | Full-text post and subreddit search        |\n| **Browse** | `get_subreddit_posts`, `get_post`, `get_comments`, `get_subreddit_info` | Read posts, comments, and subreddit info   |\n| **User**   | `get_user_profile`, `get_user_posts`, `get_user_comments`               | User profiles and activity history         |\n| **Write**  | `submit_post`, `submit_comment`, `vote`, `save_post`                    | Post, comment, vote, and save (OAuth only) |\n\n## Configuration\n\n| Variable               | Required         | Description                         |\n| ---------------------- | ---------------- | ----------------------------------- |\n| `REDDIT_CLIENT_ID`     | Yes              | OAuth2 app client ID                |\n| `REDDIT_CLIENT_SECRET` | Yes              | OAuth2 app client secret            |\n| `REDDIT_REFRESH_TOKEN` | For write tools  | Refresh token for user-level access |\n| `REDDIT_USERNAME`      | For write tools  | Reddit username                     |\n\nRead-only tools (`search_posts`, browse, and user tools) work with just `REDDIT_CLIENT_ID` and `REDDIT_CLIENT_SECRET` using app-only auth. Write tools require a valid refresh token.\n\n### OAuth2 setup\n\n1. Go to [https://www.reddit.com/prefs/apps](https://www.reddit.com/prefs/apps)\n2. Create a **script** app (for personal use) or **web app** (for user auth)\n3. Note the **client ID** (shown under the app name) and **client secret**\n4. For write access, run the OAuth2 authorization flow to obtain a refresh token\n\n## Setup\n\n### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"reddit\": {\n      \"type\": \"stdio\",\n      \"command\": \"bunx\",\n      \"args\": [\"@daanrongen/reddit-mcp\"],\n      \"env\": {\n        \"REDDIT_CLIENT_ID\": \"your-client-id\",\n        \"REDDIT_CLIENT_SECRET\": \"your-client-secret\",\n        \"REDDIT_REFRESH_TOKEN\": \"your-refresh-token\",\n        \"REDDIT_USERNAME\": \"your-username\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code CLI\n\n```bash\nclaude mcp add reddit \\\n  -e REDDIT_CLIENT_ID=your-client-id \\\n  -e REDDIT_CLIENT_SECRET=your-client-secret \\\n  -- bunx @daanrongen/reddit-mcp\n```\n\n## Development\n\n```bash\nbun install\nbun run dev        # run with --watch\nbun test           # run test suite\nbun run typecheck  # type-check without emit\nbun run lint       # biome lint\nbun run format     # biome format\nbun run build      # bundle to dist/main.js\n```\n\n## Inspecting locally\n\n`bun run inspect` launches the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) against the local build:\n\n```bash\nbun run build && bun run inspect\n```\n\nThis opens the Inspector UI in your browser where you can call any tool interactively and inspect request/response shapes.\n\n## Architecture\n\n```\nsrc/\n├── config.ts                  # Effect Config — REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, …\n├── main.ts                    # Entry point — ManagedRuntime + StdioServerTransport\n├── domain/\n│   ├── auth.test.ts           # RedditAuth unit tests\n│   ├── client.test.ts         # RedditClient unit tests\n│   ├── tools.test.ts          # Tool-level data shape tests\n│   ├── errors.ts              # RedditError, AuthError\n│   ├── models.ts              # Schema.Class models (Post, Comment, Subreddit, …)\n│   ├── RedditAuth.ts          # Context.Tag auth service interface\n│   └── RedditClient.ts        # Context.Tag client service interface\n├── infra/\n│   ├── RedditAuthLive.ts      # OAuth2 token management\n│   ├── RedditClientLive.ts    # Layer.scoped — Reddit API adapter\n│   └── RedditClientTest.ts    # In-memory test adapter\n└── mcp/\n    ├── server.ts              # McpServer wired to ManagedRuntime\n    ├── utils.ts               # formatSuccess, formatError\n    └── tools/                 # search.ts, browse.ts, user.ts, write.ts\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}