get_pinned_messages

Retrieve all pinned messages from a Discord channel by providing server and channel IDs. This tool helps users access important announcements and saved content in Discord servers.

Instructions

Get all pinned messages in a channel

Input Schema

TableJSON Schema

Name	Required	Description	Default
`guildId`	Yes	The ID of the server (guild)
`channelId`	Yes	The ID of the channel

Implementation Reference

src/tools/message-tools.ts:292-316 (handler)

The main handler function for the 'get_pinned_messages' tool. It fetches the Discord guild and channel, validates the channel type, retrieves pinned messages using Discord.js fetchPinned(), maps them to a simplified object, wraps in error handling, and returns JSON-formatted response.

  const result = await withErrorHandling(async () => {
    const client = await getDiscordClient();
    const guild = await client.guilds.fetch(guildId);
    const channel = await guild.channels.fetch(channelId);

    if (!isMessageableChannel(channel)) {
      throw new Error('Channel does not support messages');
    }

    const pinned = await channel.messages.fetchPinned();
    return pinned.map((msg) => ({
      id: msg.id,
      content: msg.content,
      authorId: msg.author.id,
      authorUsername: msg.author.username,
      createdAt: msg.createdAt.toISOString(),
    }));
  });

  if (!result.success) {
    return { content: [{ type: 'text', text: result.error }], isError: true };
  }

  return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
}

src/tools/message-tools.ts:288-291 (schema)

Zod input schema defining required parameters: guildId (string) and channelId (string).

  guildId: z.string().describe('The ID of the server (guild)'),
  channelId: z.string().describe('The ID of the channel'),
},
async ({ guildId, channelId }) => {

src/tools/message-tools.ts:285-317 (registration)

Direct registration of the 'get_pinned_messages' tool on the McpServer using server.tool(), specifying name, description, input schema, and inline handler function.

  'get_pinned_messages',
  'Get all pinned messages in a channel',
  {
    guildId: z.string().describe('The ID of the server (guild)'),
    channelId: z.string().describe('The ID of the channel'),
  },
  async ({ guildId, channelId }) => {
    const result = await withErrorHandling(async () => {
      const client = await getDiscordClient();
      const guild = await client.guilds.fetch(guildId);
      const channel = await guild.channels.fetch(channelId);

      if (!isMessageableChannel(channel)) {
        throw new Error('Channel does not support messages');
      }

      const pinned = await channel.messages.fetchPinned();
      return pinned.map((msg) => ({
        id: msg.id,
        content: msg.content,
        authorId: msg.author.id,
        authorUsername: msg.author.username,
        createdAt: msg.createdAt.toISOString(),
      }));
    });

    if (!result.success) {
      return { content: [{ type: 'text', text: result.error }], isError: true };
    }

    return { content: [{ type: 'text', text: JSON.stringify(result.data, null, 2) }] };
  }
);

src/index.ts:59-59 (registration)
Top-level call to registerMessageTools(server) within createMcpServer(), which triggers the registration of get_pinned_messages and other message tools.
```
registerMessageTools(server);
```

discord-mcp