Discord MCP server for AI agents

Let Claude, ChatGPT or your own agent read and act on Discord: 50 typed functions through one MCP server. No Discord API key needed.

Functions
50
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Discord

An MCP server for Discord alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.

https://api.bowmark.ai/mcp/site/discord
Every site

One MCP server for Discord and every other site Bowmark covers. Your agent looks up what it needs and calls it.

https://api.bowmark.ai/mcp
Set it up in your client

Both need a Bowmark API key. The quickstart gets you one and a first result in a few minutes. Functions that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 32
  • getAnnouncementReads one public announcement post (discord.com/announcements/<serverId>/<postId>).

    Arguments

    NameTypeRequired
    urlOrServerIdstringYes
    postIdstringNo

    Returns discordAnnouncement

    interface discordAnnouncementImage {
      url: string;
      width: number | null;
      height: number | null;
    }
    
    interface discordAnnouncement {
      id: string;
      serverId: string;
      serverName: string | null;
      channelName: string | null;
      headline: string;
      url: string;
      datePublished: string;
      dateModified: string | null;
      articleBody: string;
      reactionCount: number | null;
      images: discordAnnouncementImage[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/getAnnouncement

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.getAnnouncement("<urlOrServerId>");
  • getAppReads one App Directory listing (discord.com/discovery/applications/<id>).

    Arguments

    NameTypeRequired
    idstringYes

    Returns discordApp

    interface discordAppCategory {
      id: number;
      name: string;
    }
    
    interface discordAppSummary {
      id: string;
      name: string;
      description: string | null;
      iconUrl: string | null;
      verified: boolean;
      monetized: boolean;
      tags: string[];
      categories: discordAppCategory[];
      serverCount: number | null;
    }
    
    interface discordApp extends discordAppSummary {
      summary: string | null;
      termsOfServiceUrl: string | null;
      privacyPolicyUrl: string | null;
      detailedDescription: string | null;
      externalLinks: { name: string; url: string }[];
      installUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/getApp

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.getApp("<id>");
  • getDocPageReads one Discord developer docs page by url or path (e.g. /developers/resources/channel) and returns its title, description and body as clean…

    Arguments

    NameTypeRequired
    urlstringYes

    Returns discordDocPage

    interface discordDocPage {
      url: string;
      title: string;
      description: string | null;
      body: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/getDocPage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.getDocPage("/developers/resources/channel");
  • getGameReads one game's page on Discord (discord.com/game/<slug>-<id>).

    Arguments

    NameTypeRequired
    slugstringYes

    Returns discordGame

    interface discordGame {
      id: string;
      slug: string;
      url: string;
      name: string;
      description: string | null;
      genres: string[];
      platforms: string[];
      datePublished: string | null;
      imageUrl: string | null;
      publishers: string[];
      serverSlug: string | null;
      rating: { value: number; count: number } | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/getGame

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.getGame("<slug>");
  • getInviteResolves a Discord invite (discord.gg/<code>, discord.com/invite/<code> or the bare code) to the server it opens.

    Arguments

    NameTypeRequired
    codestringYes

    Returns discordInvite

    interface discordInvite {
      guildId: string;
      guildName: string;
      guildDescription: string | null;
      guildFeatures: string[];
      approximateMemberCount: number;
      approximatePresenceCount: number;
      expiresAt: string | null;
      channelId?: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/getInvite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.getInvite("discord-developers");
  • getMyProfileReads the signed-in caller's own account.

    Arguments

    None.

    Returns discordMyProfile

    interface discordMyProfile {
      id: string;
      username: string;
      globalName: string | null;
      avatarUrl: string | null;
      bio: string | null;
      pronouns: string | null;
      verified: boolean;                 // email verified
      nitro: "none" | "classic" | "nitro" | "basic";
      locale: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/getMyProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.getMyProfile();
  • getServerReads one server's public directory page (discord.com/servers/<slug>-<id>).

    Arguments

    NameTypeRequired
    slugOrIdstringYes

    Returns discordServer

    interface discordServer {
      id: string;
      slug: string;
      url: string;
      name: string;
      description: string | null;
      about: string | null;
      joinReasons: string[];
      onlineCount: number | null;
      memberCount: number | null;
      verified: boolean;
      categories: string[];
      languages: string[];
      established: string | null;
      socialLinks: string[];
      iconUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/getServer

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.getServer("<slugOrId>");
  • getUserProfileReads another user's profile.

    Arguments

    NameTypeRequired
    args{ userId: string }Yes

    Returns discordUserProfile

    interface discordUserProfile {
      id: string;
      username: string;
      globalName: string | null;
      avatarUrl: string | null;
      bannerUrl: string | null;
      bio: string | null;
      pronouns: string | null;
      bot: boolean;
      badges: string[];                  // badge descriptions, e.g. "Active Developer"
      mutualServers: { id: string; nickname: string | null }[];
      mutualFriends: { id: string; username: string; globalName: string | null }[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/getUserProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.getUserProfile({ userId: "1000000000000000000" });
  • listAppCategoriesLists the App Directory's categories (Games, Entertainment, Moderation and Tools, Social, Utilities) with the ids searchApps' row-level categories…

    Arguments

    None.

    Returns discordAppCategory[]

    interface discordAppCategory {
      id: number;
      name: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listAppCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listAppCategories();
  • listBlogPostsLists Discord's own blog posts (discord.com/blog).

    Arguments

    None.

    Returns discordBlogPost[]

    interface discordBlogPost {
      title: string;
      url: string;
      publishedAt: string | null;
      summary: string | null;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listBlogPosts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listBlogPosts();
  • listChannelsLists one joined server's channels the caller can see.

    Arguments

    NameTypeRequired
    guildIdstringYes

    Returns discordChannel[]

    interface discordChannel {
      id: string;
      name: string;
      type: "text" | "voice" | "announcement" | "stage" | "forum";
      topic: string | null;
      category: string | null;           // the category channel this one sits under, or null
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listChannels

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listChannels("1000000000000000000");
  • listDirectMessagesLists the caller's DM and group-DM conversations.

    Arguments

    None.

    Returns discordDirectMessage[]

    interface discordDirectMessage {
      id: string;                        // the DM channel id, pass to listMessages / searchMessages
      type: "dm" | "group";
      name: string | null;               // a group DM's name, else null
      recipients: { id: string; username: string; globalName: string | null }[];
      lastMessageId: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listDirectMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listDirectMessages();
  • listDocPagesLists every page of Discord's developer documentation (REST resources, Gateway, interactions, Social SDK, guides).

    Arguments

    None.

    Returns discordDocLink[]

    interface discordDocLink {
      title: string;
      url: string;
      description: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listDocPages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listDocPages();
  • listFeaturedAppsLists the App Directory's featured collections ("Action Games" and the rest).

    Arguments

    None.

    Returns discordAppCollection[]

    interface discordAppCategory {
      id: number;
      name: string;
    }
    
    interface discordAppSummary {
      id: string;
      name: string;
      description: string | null;
      iconUrl: string | null;
      verified: boolean;
      monetized: boolean;
      tags: string[];
      categories: discordAppCategory[];
      serverCount: number | null;
    }
    
    interface discordApp extends discordAppSummary {
      summary: string | null;
      termsOfServiceUrl: string | null;
      privacyPolicyUrl: string | null;
      detailedDescription: string | null;
      externalLinks: { name: string; url: string }[];
      installUrl: string | null;
    }
    
    interface discordAppCollection {
      id: string;
      title: string;
      description: string;
      apps: discordApp[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listFeaturedApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listFeaturedApps();
  • listFriendRequestsLists the caller's pending incoming and outgoing friend requests.

    Arguments

    None.

    Returns discordFriendRequest[]

    interface discordFriend {
      id: string;                        // the friend's user id
      username: string;
      globalName: string | null;
      nickname: string | null;           // the caller's private nickname for them
      avatarUrl: string | null;
      since: string | null;              // ISO 8601
    }
    
    interface discordFriendRequest extends discordFriend {
      direction: "incoming" | "outgoing";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listFriendRequests

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listFriendRequests();
  • listFriendsLists the caller's friends.

    Arguments

    None.

    Returns discordFriend[]

    interface discordFriend {
      id: string;                        // the friend's user id
      username: string;
      globalName: string | null;
      nickname: string | null;           // the caller's private nickname for them
      avatarUrl: string | null;
      since: string | null;              // ISO 8601
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listFriends

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listFriends();
  • listMentionsLists the recent messages that mentioned the caller across their servers.

    Arguments

    NameTypeRequired
    args{ limit?: number; guildId?: string }No

    Returns discordMention[]

    interface discordMessage {
      id: string;
      channelId: string;
      author: { id: string; username: string; globalName: string | null };
      content: string;
      timestamp: string;                 // ISO 8601
      editedTimestamp: string | null;
      attachments: string[];             // attachment urls
      embedCount: number;
      reactions: { emoji: string; count: number; me: boolean }[];
      referencedMessageId: string | null; // the message this one replies to
      pinned: boolean;
    }
    
    interface discordMention extends discordMessage {
      guildId: string | null;            // null for a DM
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listMentions

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listMentions();
  • listMessagesReads a channel's or DM's recent messages, newest first, paging backwards.

    Arguments

    NameTypeRequired
    args{ channelId: string; limit?: number }Yes

    Returns discordChannelMessages

    interface discordMessage {
      id: string;
      channelId: string;
      author: { id: string; username: string; globalName: string | null };
      content: string;
      timestamp: string;                 // ISO 8601
      editedTimestamp: string | null;
      attachments: string[];             // attachment urls
      embedCount: number;
      reactions: { emoji: string; count: number; me: boolean }[];
      referencedMessageId: string | null; // the message this one replies to
      pinned: boolean;
    }
    
    interface discordChannelMessages {
      channelId: string;
      messages: discordMessage[];        // newest first; [] for an empty channel
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listMessages({ channelId: "1000000000000000000" });
  • listMyServersLists the servers the signed-in caller has joined.

    Arguments

    None.

    Returns discordMyServer[]

    interface discordMyServer {
      id: string;                        // the server id other session functions take
      name: string;
      iconUrl: string | null;
      owner: boolean;
      permissions: string | null;        // Discord's permission bitfield, as a string
      memberCount: number | null;        // approximate
      onlineCount: number | null;        // approximate
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listMyServers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listMyServers();
  • listPinnedMessagesLists the messages pinned in a channel.

    Arguments

    NameTypeRequired
    args{ channelId: string }Yes

    Returns discordPinnedMessage[]

    interface discordMessage {
      id: string;
      channelId: string;
      author: { id: string; username: string; globalName: string | null };
      content: string;
      timestamp: string;                 // ISO 8601
      editedTimestamp: string | null;
      attachments: string[];             // attachment urls
      embedCount: number;
      reactions: { emoji: string; count: number; me: boolean }[];
      referencedMessageId: string | null; // the message this one replies to
      pinned: boolean;
    }
    
    interface discordPinnedMessage extends discordMessage {
      pinnedAt: string | null;           // ISO 8601
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listPinnedMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listPinnedMessages({ channelId: "1000000000000000000" });
  • listQuestsLists the Quests currently offered to the caller.

    Arguments

    None.

    Returns discordQuest[]

    interface discordQuest {
      id: string;
      name: string;
      game: string | null;
      tasks: { type: string; seconds: number | null }[];   // e.g. PLAY_ON_DESKTOP, 900
      rewards: string[];
      startsAt: string | null;
      expiresAt: string | null;
      enrolledAt: string | null;         // null until the caller accepts it
      completedAt: string | null;
      claimedAt: string | null;
      progress: Record<string, number>;  // seconds done per task type
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listQuests

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listQuests();
  • listServerAnnouncementsLists the posts a server publishes to its public announcements page (discord.com/announcements/<serverId>).

    Arguments

    NameTypeRequired
    serverIdstringYes

    Returns discordServerAnnouncements

    interface discordAnnouncementImage {
      url: string;
      width: number | null;
      height: number | null;
    }
    
    interface discordAnnouncementSummary {
      id: string;
      headline: string;
      url: string;
      datePublished: string;
      reactionCount: number | null;
      images: discordAnnouncementImage[];
    }
    
    interface discordServerAnnouncements {
      serverId: string;
      serverName: string | null;
      channelName: string | null;
      posts: discordAnnouncementSummary[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listServerAnnouncements

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listServerAnnouncements("889960284020699156");
  • listServerCategoriesLists the public server directory's categories (Gaming, Entertainment, Education, Music, Science & Tech) with each one's server count and the slug…

    Arguments

    None.

    Returns discordServerCategory[]

    interface discordServerCategory {
      name: string;
      slug: string;
      url: string;
      serverCount: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listServerCategories

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listServerCategories();
  • listServerEventsLists a joined server's scheduled events.

    Arguments

    NameTypeRequired
    args{ guildId: string }Yes

    Returns discordServerEvent[]

    interface discordServerEvent {
      id: string;
      name: string;
      description: string | null;
      startsAt: string | null;           // ISO 8601
      endsAt: string | null;
      status: "scheduled" | "active" | "completed" | "canceled" | null;
      kind: "stage" | "voice" | "external" | null;
      channelId: string | null;          // the stage/voice channel
      location: string | null;           // external events only
      creatorId: string | null;
      interestedCount: number | null;
      imageUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listServerEvents

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listServerEvents({ guildId: "1000000000000000000" });
  • listServersBrowses Discord's public server directory with no keyword, in the directory's own featured order, all servers or one category.

    Arguments

    NameTypeRequired
    opts{ category?: string; offset?: number }No

    Returns discordServerSearch

    interface discordDirectoryServer {
      id: string;
      name: string;
      slug: string;
      url: string;
      description: string | null;
      badge: string | null;
      onlineCount: number | null;
      memberCount: number | null;
      iconUrl: string | null;
    }
    
    interface discordServerSearch {
      query: string;
      category: string | null;
      offset: number;
      total: number | null;
      servers: discordDirectoryServer[];
      nextOffset: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listServers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listServers();
  • listSimilarAppsLists the apps the App Directory shows as similar to one app.

    Arguments

    NameTypeRequired
    idstringYes

    Returns discordApp[]

    interface discordAppCategory {
      id: number;
      name: string;
    }
    
    interface discordAppSummary {
      id: string;
      name: string;
      description: string | null;
      iconUrl: string | null;
      verified: boolean;
      monetized: boolean;
      tags: string[];
      categories: discordAppCategory[];
      serverCount: number | null;
    }
    
    interface discordApp extends discordAppSummary {
      summary: string | null;
      termsOfServiceUrl: string | null;
      privacyPolicyUrl: string | null;
      detailedDescription: string | null;
      externalLinks: { name: string; url: string }[];
      installUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listSimilarApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listSimilarApps("1211781489931452447");
  • listThreadsLists the active threads in a channel, or the posts in a forum channel.

    Arguments

    NameTypeRequired
    args{ channelId: string; archived?: boolean; offset?: number }Yes

    Returns discordThreadList

    interface discordThread {
      id: string;                        // the thread's channel id, pass to listMessages
      name: string;
      ownerId: string | null;
      messageCount: number | null;
      archived: boolean;
      lastMessageId: string | null;
      tagIds: string[];                  // forum tags applied
      createdAt: string | null;
    }
    
    interface discordThreadList {
      channelId: string;
      totalResults: number | null;
      hasMore: boolean;                  // step offset by 25 for more
      threads: discordThread[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listThreads

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listThreads({ channelId: "1000000000000000000" });
  • listTrendingGamesLists the games trending on Discord this week (discord.com/trending-games), overall or in one genre.

    Arguments

    NameTypeRequired
    categorystringNo

    Returns discordTrendingGame[]

    interface discordTrendingGame {
      rank: number;
      name: string;
      slug: string;
      id: string;
      coverImageUrl: string | null;
      playsChange: string | null;
      streamsChange: string | null;
      categories: string[];
      server: {
        name: string;
        slug: string;
        memberCountLabel: string | null;
        onlineCount: number | null;
        joinUrl: string | null;
      } | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/listTrendingGames

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.listTrendingGames();
  • searchAppsSearches Discord's App Directory (discord.com/discovery/applications) for bots, games and activities by keyword.

    Arguments

    NameTypeRequired
    querystringYes

    Returns discordAppSearch

    interface discordAppCategory {
      id: number;
      name: string;
    }
    
    interface discordAppSummary {
      id: string;
      name: string;
      description: string | null;
      iconUrl: string | null;
      verified: boolean;
      monetized: boolean;
      tags: string[];
      categories: discordAppCategory[];
      serverCount: number | null;
    }
    
    interface discordAppSearch {
      query: string;
      page: number;
      numPages: number;
      resultCount: number;
      apps: discordAppSummary[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/searchApps

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.searchApps("midjourney");
  • searchMessagesSearches the messages in one joined server (or the caller's DMs) by text, author, channel, date or has:link/file.

    Arguments

    NameTypeRequired
    args{ guildId?: string; channelId?: string; query?: string; authorId?: string; has?: "link" | "embed" | "file" | "image" | "video" | "sound" | "sticker" | "poll"; offset?: number }Yes

    Returns discordMessageSearch

    interface discordMessage {
      id: string;
      channelId: string;
      author: { id: string; username: string; globalName: string | null };
      content: string;
      timestamp: string;                 // ISO 8601
      editedTimestamp: string | null;
      attachments: string[];             // attachment urls
      embedCount: number;
      reactions: { emoji: string; count: number; me: boolean }[];
      referencedMessageId: string | null; // the message this one replies to
      pinned: boolean;
    }
    
    interface discordMessageSearch {
      totalResults: number;              // Discord's count of every hit, not just this page (25 per page)
      messages: discordMessage[];        // this page's hits
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/searchMessages

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.searchMessages({ guildId: "1000000000000000000", query: "hello" });
  • searchServerMembersFinds members of a joined server by name.

    Arguments

    NameTypeRequired
    args{ guildId: string; query: string; limit?: number }Yes

    Returns discordServerMember[]

    interface discordServerMember {
      id: string;                        // user id, pass to getUserProfile
      username: string;
      globalName: string | null;
      nickname: string | null;           // this server's nickname
      avatarUrl: string | null;
      bot: boolean;
      roleIds: string[];
      joinedAt: string | null;           // ISO 8601
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/searchServerMembers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.searchServerMembers({ guildId: "1000000000000000000", query: "a" });
  • searchServersSearches Discord's public server directory (discord.com/servers) by keyword, optionally inside one category.

    Arguments

    NameTypeRequired
    querystringYes
    opts{ category?: string; offset?: number }No

    Returns discordServerSearch

    interface discordDirectoryServer {
      id: string;
      name: string;
      slug: string;
      url: string;
      description: string | null;
      badge: string | null;
      onlineCount: number | null;
      memberCount: number | null;
      iconUrl: string | null;
    }
    
    interface discordServerSearch {
      query: string;
      category: string | null;
      offset: number;
      total: number | null;
      servers: discordDirectoryServer[];
      nextOffset: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/searchServers

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.searchServers("minecraft");
Act 18
  • acceptFriendRequestAccepts a pending incoming friend request.

    Arguments

    NameTypeRequired
    args{ userId: string }Yes

    Returns discordRelationshipResult

    interface discordRelationshipResult {
      userId: string | null;
      username: string | null;
      action: "friend-request-sent" | "friend-request-accepted" | "friend-removed" | "blocked";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/acceptFriendRequest

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.acceptFriendRequest({});
  • addReactionAdds an emoji reaction to a message as the caller.

    Arguments

    NameTypeRequired
    args{ channelId: string; messageId: string; emoji: string }Yes

    Returns discordReactionResult

    interface discordReactionResult {
      channelId: string;
      messageId: string;
      emoji: string;                     // as sent: "👍" or "name:id"
      ok: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/addReaction

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.addReaction({});
  • blockUserBlocks a user.

    Arguments

    NameTypeRequired
    args{ userId: string }Yes

    Returns discordRelationshipResult

    interface discordRelationshipResult {
      userId: string | null;
      username: string | null;
      action: "friend-request-sent" | "friend-request-accepted" | "friend-removed" | "blocked";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/blockUser

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.blockUser({});
  • createInviteCreates an invite link to a channel the caller may invite to, with an optional expiry and use limit.

    Arguments

    NameTypeRequired
    args{ channelId: string; expiresInSeconds?: number; useLimit?: number }Yes

    Returns discordCreatedInvite

    interface discordCreatedInvite {
      code: string;
      url: string;                       // https://discord.gg/<code>
      channelId: string;
      guildId: string | null;
      expiresAt: string | null;          // ISO, null = never expires
      expiresInSeconds: number | null;
      useLimit: number | null;            // 0 = unlimited
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/createInvite

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.createInvite({});
  • createServerCreates a new server owned by the caller, with a name and optional icon.

    Arguments

    NameTypeRequired
    args{ name: string; icon?: string }Yes

    Returns discordCreatedServer

    interface discordCreatedServer {
      id: string;
      name: string;
      ownerId: string | null;
      systemChannelId: string | null;    // the first text channel, pass to sendMessage or createInvite
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/createServer

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.createServer({});
  • createThreadStarts a thread from a message, or a new post in a forum channel, as the caller.

    Arguments

    NameTypeRequired
    args{ channelId: string; name: string; messageId?: string; content?: string; tagIds?: string[] }Yes

    Returns discordThread

    interface discordThread {
      id: string;                        // the thread's channel id, pass to listMessages
      name: string;
      ownerId: string | null;
      messageCount: number | null;
      archived: boolean;
      lastMessageId: string | null;
      tagIds: string[];                  // forum tags applied
      createdAt: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/createThread

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.createThread({});
  • deleteMessageDeletes a message the caller sent (or, with the permission, anyone's in a server they moderate).

    Arguments

    NameTypeRequired
    args{ channelId: string; messageId: string }Yes

    Returns discordDeleteResult

    interface discordDeleteResult {
      channelId: string;
      messageId: string;
      deleted: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/deleteMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.deleteMessage({});
  • editMessageEdits the text of a message the caller sent.

    Arguments

    NameTypeRequired
    args{ channelId: string; messageId: string; content: string }Yes

    Returns discordMessage

    interface discordMessage {
      id: string;
      channelId: string;
      author: { id: string; username: string; globalName: string | null };
      content: string;
      timestamp: string;                 // ISO 8601
      editedTimestamp: string | null;
      attachments: string[];             // attachment urls
      embedCount: number;
      reactions: { emoji: string; count: number; me: boolean }[];
      referencedMessageId: string | null; // the message this one replies to
      pinned: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/editMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.editMessage({});
  • joinServerJoins a server from an invite code or link as the caller.

    Arguments

    NameTypeRequired
    args{ invite: string }Yes

    Returns discordJoinResult

    interface discordJoinResult {
      code: string;
      guildId: string | null;
      guildName: string | null;
      channelId: string | null;          // the channel the invite lands on
      newMember: boolean | null;         // false when the caller was already a member
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/joinServer

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.joinServer({});
  • leaveServerLeaves a server the caller has joined.

    Arguments

    NameTypeRequired
    args{ guildId: string }Yes

    Returns discordLeaveResult

    interface discordLeaveResult {
      guildId: string;
      left: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/leaveServer

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.leaveServer({});
  • removeFriendRemoves a friend, or cancels or declines a pending request.

    Arguments

    NameTypeRequired
    args{ userId: string }Yes

    Returns discordRelationshipResult

    interface discordRelationshipResult {
      userId: string | null;
      username: string | null;
      action: "friend-request-sent" | "friend-request-accepted" | "friend-removed" | "blocked";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/removeFriend

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.removeFriend({});
  • removeReactionRemoves the caller's own emoji reaction from a message.

    Arguments

    NameTypeRequired
    args{ channelId: string; messageId: string; emoji: string }Yes

    Returns discordReactionResult

    interface discordReactionResult {
      channelId: string;
      messageId: string;
      emoji: string;                     // as sent: "👍" or "name:id"
      ok: true;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/removeReaction

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.removeReaction({});
  • sendDirectMessageSends a direct message to one user by username or user id, opening the DM if none exists yet.

    Arguments

    NameTypeRequired
    args{ userId: string; content: string }Yes

    Returns discordMessage

    interface discordMessage {
      id: string;
      channelId: string;
      author: { id: string; username: string; globalName: string | null };
      content: string;
      timestamp: string;                 // ISO 8601
      editedTimestamp: string | null;
      attachments: string[];             // attachment urls
      embedCount: number;
      reactions: { emoji: string; count: number; me: boolean }[];
      referencedMessageId: string | null; // the message this one replies to
      pinned: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/sendDirectMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.sendDirectMessage({});
  • sendFriendRequestSends a friend request to a user by username.

    Arguments

    NameTypeRequired
    args{ username?: string; userId?: string }Yes

    Returns discordRelationshipResult

    interface discordRelationshipResult {
      userId: string | null;
      username: string | null;
      action: "friend-request-sent" | "friend-request-accepted" | "friend-removed" | "blocked";
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/sendFriendRequest

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.sendFriendRequest({});
  • sendMessagePosts a message as the signed-in caller to a channel or DM, optionally as a reply to one message.

    Arguments

    NameTypeRequired
    args{ channelId: string; content: string; replyToMessageId?: string }Yes

    Returns discordMessage

    interface discordMessage {
      id: string;
      channelId: string;
      author: { id: string; username: string; globalName: string | null };
      content: string;
      timestamp: string;                 // ISO 8601
      editedTimestamp: string | null;
      attachments: string[];             // attachment urls
      embedCount: number;
      reactions: { emoji: string; count: number; me: boolean }[];
      referencedMessageId: string | null; // the message this one replies to
      pinned: boolean;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/sendMessage

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.sendMessage({});
  • setAvatarChanges the caller's profile picture.

    Arguments

    NameTypeRequired
    args{ image: string | null }Yes

    Returns discordAvatarResult

    interface discordAvatarResult {
      userId: string | null;
      avatar: string | null;             // hash; null = avatar removed
      avatarUrl: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/setAvatar

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.setAvatar({});
  • setStatusSets the caller's presence (online, idle, do not disturb, invisible) and custom status text.

    Arguments

    NameTypeRequired
    args{ status?: 'online' | 'idle' | 'dnd' | 'invisible'; text?: string | null }Yes

    Returns discordStatusResult

    interface discordStatusResult {
      status: "online" | "idle" | "dnd" | "invisible" | null;
      customStatus: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/setStatus

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.setStatus({});
  • updateProfileChanges the caller's display name, bio (About Me) or pronouns.

    Arguments

    NameTypeRequired
    args{ displayName?: string; bio?: string; pronouns?: string }Yes

    Returns discordProfileResult

    interface discordProfileResult {
      userId: string | null;
      displayName: string | null;
      bio: string | null;
      pronouns: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/discord/updateProfile

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.discord.updateProfile({});

Use it from code