@prmichaelsen/reddit-mcp 0.1.0 → 0.1.1

package/dist/tools/account.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerAccountTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=account.d.ts.map

package/dist/tools/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/tools/account.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CA4EN"}

package/dist/tools/comments.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerCommentTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=comments.d.ts.map

package/dist/tools/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/tools/comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcxD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CAqDN"}

package/dist/tools/flair.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerFlairTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=flair.d.ts.map

package/dist/tools/flair.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flair.d.ts","sourceRoot":"","sources":["../../src/tools/flair.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcxD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CA2DN"}

package/dist/tools/messages.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerMessageTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=messages.d.ts.map

package/dist/tools/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/tools/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAyBxD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CA+FN"}

package/dist/tools/moderation.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerModerationTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=moderation.d.ts.map

package/dist/tools/moderation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"moderation.d.ts","sourceRoot":"","sources":["../../src/tools/moderation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAyBxD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CAqQN"}

package/dist/tools/multireddits.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerMultiredditTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=multireddits.d.ts.map

package/dist/tools/multireddits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multireddits.d.ts","sourceRoot":"","sources":["../../src/tools/multireddits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CAgJN"}

package/dist/tools/posts.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerPostTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=posts.d.ts.map

package/dist/tools/posts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"posts.d.ts","sourceRoot":"","sources":["../../src/tools/posts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAcxD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CA6JN"}

package/dist/tools/subreddits.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerSubredditTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=subreddits.d.ts.map

package/dist/tools/subreddits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subreddits.d.ts","sourceRoot":"","sources":["../../src/tools/subreddits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAyBxD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CA0GN"}

package/dist/tools/users.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerUserTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=users.d.ts.map

package/dist/tools/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../src/tools/users.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAiCxD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CA8IN"}

package/dist/tools/voting.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerVotingTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=voting.d.ts.map

package/dist/tools/voting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voting.d.ts","sourceRoot":"","sources":["../../src/tools/voting.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CAkFN"}

package/dist/tools/wiki.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { RedditClient } from "../client/reddit.js";
+export declare function registerWikiTools(server: McpServer, client: RedditClient): void;
+//# sourceMappingURL=wiki.d.ts.map

package/dist/tools/wiki.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../src/tools/wiki.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAyBxD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,YAAY,GACnB,IAAI,CAuFN"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prmichaelsen/reddit-mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "MCP server wrapping the Reddit API for AI agents",
   "main": "dist/index.js",
   "exports": {

package/src/server.ts

@@ -3,6 +3,17 @@ import { RedditAuth } from "./auth/oauth.js";
 import { RedditClient } from "./client/reddit.js";
 import { registerListingTools } from "./tools/listings.js";
 import { registerSearchTools } from "./tools/search.js";
+import { registerPostTools } from "./tools/posts.js";
+import { registerCommentTools } from "./tools/comments.js";
+import { registerVotingTools } from "./tools/voting.js";
+import { registerAccountTools } from "./tools/account.js";
+import { registerUserTools } from "./tools/users.js";
+import { registerMessageTools } from "./tools/messages.js";
+import { registerSubredditTools } from "./tools/subreddits.js";
+import { registerFlairTools } from "./tools/flair.js";
+import { registerModerationTools } from "./tools/moderation.js";
+import { registerMultiredditTools } from "./tools/multireddits.js";
+import { registerWikiTools } from "./tools/wiki.js";
 
 export function createServer(auth?: RedditAuth): McpServer {
   const server = new McpServer({
@@ -33,4 +44,15 @@ export function createServerWithToken(accessToken: string): McpServer {
 function registerAllTools(server: McpServer, client: RedditClient): void {
   registerListingTools(server, client);
   registerSearchTools(server, client);
+  registerPostTools(server, client);
+  registerCommentTools(server, client);
+  registerVotingTools(server, client);
+  registerAccountTools(server, client);
+  registerUserTools(server, client);
+  registerMessageTools(server, client);
+  registerSubredditTools(server, client);
+  registerFlairTools(server, client);
+  registerModerationTools(server, client);
+  registerMultiredditTools(server, client);
+  registerWikiTools(server, client);
 }

package/src/tools/account.ts

@@ -0,0 +1,84 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { RedditClient } from "../client/reddit.js";
+
+export function registerAccountTools(
+  server: McpServer,
+  client: RedditClient,
+): void {
+  server.tool(
+    "reddit_me",
+    "Get the authenticated user's account info (username, karma, etc). Requires 'identity' scope.",
+    {},
+    async () => {
+      const data = await client.get("/api/v1/me");
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_me_karma",
+    "Get the authenticated user's karma breakdown by subreddit. Requires 'mysubreddits' scope.",
+    {},
+    async () => {
+      const data = await client.get("/api/v1/me/karma");
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_me_prefs",
+    "Get the authenticated user's preferences. Requires 'identity' scope.",
+    {},
+    async () => {
+      const data = await client.get("/api/v1/me/prefs");
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_me_prefs_update",
+    "Update the authenticated user's preferences. Requires 'account' scope. Pass a JSON object with preference keys and values.",
+    {
+      prefs: z
+        .record(z.string(), z.unknown())
+        .describe(
+          "JSON object of preference key-value pairs to update (e.g. {\"over_18\": true, \"hide_downs\": false})",
+        ),
+    },
+    async (input) => {
+      const data = await client.patch("/api/v1/me/prefs", input.prefs);
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_me_trophies",
+    "Get the authenticated user's trophies. Requires 'identity' scope.",
+    {},
+    async () => {
+      const data = await client.get("/api/v1/me/trophies");
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_me_friends",
+    "Get the authenticated user's friends list. Requires 'mysubreddits' scope.",
+    {},
+    async () => {
+      const data = await client.get("/prefs/friends");
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_me_blocked",
+    "Get the authenticated user's blocked users list. Requires 'mysubreddits' scope.",
+    {},
+    async () => {
+      const data = await client.get("/prefs/blocked");
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+}

package/src/tools/comments.ts

@@ -0,0 +1,73 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { RedditClient } from "../client/reddit.js";
+
+function buildParams(
+  input: Record<string, unknown>,
+): Record<string, string | undefined> {
+  const params: Record<string, string | undefined> = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (value !== undefined && value !== null) {
+      params[key] = String(value);
+    }
+  }
+  return params;
+}
+
+export function registerCommentTools(
+  server: McpServer,
+  client: RedditClient,
+): void {
+  server.tool(
+    "reddit_comment",
+    "Post a comment or reply. Use a t3_ fullname as parent for a top-level comment on a post, or a t1_ fullname to reply to another comment. Requires 'submit' scope.",
+    {
+      parent: z
+        .string()
+        .describe(
+          "Fullname of the parent: t3_ for a post (top-level comment) or t1_ for a comment (reply)",
+        ),
+      text: z.string().describe("Comment body text (markdown)"),
+    },
+    async (input) => {
+      const data = await client.post("/api/comment", {
+        ...buildParams(input),
+        api_type: "json",
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_more_children",
+    "Load more comments from collapsed 'load more' stubs in a comment thread. Requires 'read' scope.",
+    {
+      link_id: z
+        .string()
+        .describe("Fullname of the parent post (t3_)"),
+      children: z
+        .string()
+        .describe(
+          "Comma-separated list of comment IDs to expand (from the 'more' object's children array)",
+        ),
+      sort: z
+        .enum(["confidence", "top", "new", "controversial", "old", "qa"])
+        .optional()
+        .describe("Comment sort order"),
+      limit_children: z
+        .boolean()
+        .optional()
+        .describe("If true, only return the children requested (no deeper)"),
+    },
+    async (input) => {
+      const data = await client.get(
+        "/api/morechildren",
+        {
+          ...buildParams(input),
+          api_type: "json",
+        },
+      );
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+}

package/src/tools/flair.ts

@@ -0,0 +1,79 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { RedditClient } from "../client/reddit.js";
+
+function buildParams(
+  input: Record<string, unknown>,
+): Record<string, string | undefined> {
+  const params: Record<string, string | undefined> = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (value !== undefined && value !== null) {
+      params[key] = String(value);
+    }
+  }
+  return params;
+}
+
+export function registerFlairTools(
+  server: McpServer,
+  client: RedditClient,
+): void {
+  server.tool(
+    "reddit_link_flair",
+    "Get available link (post) flair templates for a subreddit. Requires 'flair' scope.",
+    {
+      subreddit: z.string().describe("Subreddit name (without r/ prefix)"),
+    },
+    async (input) => {
+      const data = await client.get(
+        `/r/${input.subreddit}/api/link_flair_v2`,
+      );
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_user_flair",
+    "Get available user flair templates for a subreddit. Requires 'flair' scope.",
+    {
+      subreddit: z.string().describe("Subreddit name (without r/ prefix)"),
+    },
+    async (input) => {
+      const data = await client.get(
+        `/r/${input.subreddit}/api/user_flair_v2`,
+      );
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_select_flair",
+    "Set flair on a post or user in a subreddit. Provide 'link' for post flair or 'name' for user flair. Requires 'flair' scope.",
+    {
+      subreddit: z.string().describe("Subreddit name (without r/ prefix)"),
+      flair_template_id: z
+        .string()
+        .describe("Flair template ID (from link_flair or user_flair listing)"),
+      link: z
+        .string()
+        .optional()
+        .describe("Post fullname (t3_) to set link flair on"),
+      name: z
+        .string()
+        .optional()
+        .describe("Username to set user flair for"),
+      text: z
+        .string()
+        .optional()
+        .describe("Custom flair text (if template allows)"),
+    },
+    async (input) => {
+      const { subreddit, ...rest } = input;
+      const data = await client.post(
+        `/r/${subreddit}/api/selectflair`,
+        buildParams(rest),
+      );
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+}

package/src/tools/messages.ts

@@ -0,0 +1,126 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import type { RedditClient } from "../client/reddit.js";
+
+const paginationParams = {
+  limit: z
+    .number()
+    .min(1)
+    .max(100)
+    .optional()
+    .describe("Number of messages to return (1-100, default 25)"),
+  after: z.string().optional().describe("Fullname to paginate after"),
+  before: z.string().optional().describe("Fullname to paginate before"),
+};
+
+function buildParams(
+  input: Record<string, unknown>,
+): Record<string, string | undefined> {
+  const params: Record<string, string | undefined> = {};
+  for (const [key, value] of Object.entries(input)) {
+    if (value !== undefined && value !== null) {
+      params[key] = String(value);
+    }
+  }
+  return params;
+}
+
+export function registerMessageTools(
+  server: McpServer,
+  client: RedditClient,
+): void {
+  server.tool(
+    "reddit_inbox",
+    "Get the authenticated user's inbox messages. Requires 'privatemessages' scope.",
+    { ...paginationParams },
+    async (input) => {
+      const data = await client.get("/message/inbox", buildParams(input));
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_unread",
+    "Get the authenticated user's unread messages. Requires 'privatemessages' scope.",
+    { ...paginationParams },
+    async (input) => {
+      const data = await client.get("/message/unread", buildParams(input));
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_sent",
+    "Get the authenticated user's sent messages. Requires 'privatemessages' scope.",
+    { ...paginationParams },
+    async (input) => {
+      const data = await client.get("/message/sent", buildParams(input));
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_compose",
+    "Send a private message to a user. Requires 'privatemessages' scope.",
+    {
+      to: z.string().describe("Recipient username (without /u/ prefix)"),
+      subject: z.string().describe("Message subject"),
+      text: z.string().describe("Message body (markdown)"),
+    },
+    async (input) => {
+      const data = await client.post("/api/compose", {
+        ...buildParams(input),
+        api_type: "json",
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_read_message",
+    "Mark a message as read. Requires 'privatemessages' scope.",
+    {
+      id: z
+        .string()
+        .describe("Fullname of the message to mark as read (t4_)"),
+    },
+    async (input) => {
+      const data = await client.post("/api/read_message", {
+        id: input.id,
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_unread_message",
+    "Mark a message as unread. Requires 'privatemessages' scope.",
+    {
+      id: z
+        .string()
+        .describe("Fullname of the message to mark as unread (t4_)"),
+    },
+    async (input) => {
+      const data = await client.post("/api/unread_message", {
+        id: input.id,
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+
+  server.tool(
+    "reddit_del_msg",
+    "Delete a message from your inbox. Requires 'privatemessages' scope.",
+    {
+      id: z
+        .string()
+        .describe("Fullname of the message to delete (t4_)"),
+    },
+    async (input) => {
+      const data = await client.post("/api/del_msg", {
+        id: input.id,
+      });
+      return { content: [{ type: "text", text: JSON.stringify(data) }] };
+    },
+  );
+}