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.
- Site
- discord.com
- Functions
- 50
- Sign-in
- For account actions
- Works with
- MCP, HTTP, Node, Python
Connect
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/discordOne MCP server for Discord and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth 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.
getAnnouncementReads one public announcement post (discord.com/announcements/<serverId>/<postId>).Arguments
Name Type Required urlOrServerIdstringYes postIdstringNo Returns
discordAnnouncementinterface 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/getAnnouncementCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.getAnnouncement("<urlOrServerId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.getAnnouncement("<urlOrServerId>"))curl -X POST https://api.bowmark.ai/v1/sites/discord/getAnnouncement \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"urlOrServerId":"<urlOrServerId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.getAnnouncement("<urlOrServerId>");getAppReads one App Directory listing (discord.com/discovery/applications/<id>).Arguments
Name Type Required idstringYes Returns
discordAppinterface 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/getAppCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.getApp("<id>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.getApp("<id>"))curl -X POST https://api.bowmark.ai/v1/sites/discord/getApp \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"<id>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringYes Returns
discordDocPageinterface discordDocPage { url: string; title: string; description: string | null; body: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discord/getDocPageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.getDocPage("/developers/resources/channel");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.getDocPage("/developers/resources/channel"))curl -X POST https://api.bowmark.ai/v1/sites/discord/getDocPage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"/developers/resources/channel"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.getDocPage("/developers/resources/channel");getGameReads one game's page on Discord (discord.com/game/<slug>-<id>).Arguments
Name Type Required slugstringYes Returns
discordGameinterface 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/getGameCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.getGame("<slug>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.getGame("<slug>"))curl -X POST https://api.bowmark.ai/v1/sites/discord/getGame \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slug":"<slug>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required codestringYes Returns
discordInviteinterface 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/getInviteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.getInvite("discord-developers");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.getInvite("discord-developers"))curl -X POST https://api.bowmark.ai/v1/sites/discord/getInvite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"code":"discord-developers"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.getInvite("discord-developers");getMyProfileReads the signed-in caller's own account.Arguments
None.
Returns
discordMyProfileinterface 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/getMyProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.getMyProfile();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.getMyProfile())curl -X POST https://api.bowmark.ai/v1/sites/discord/getMyProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.getMyProfile();getServerReads one server's public directory page (discord.com/servers/<slug>-<id>).Arguments
Name Type Required slugOrIdstringYes Returns
discordServerinterface 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/getServerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.getServer("<slugOrId>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.getServer("<slugOrId>"))curl -X POST https://api.bowmark.ai/v1/sites/discord/getServer \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slugOrId":"<slugOrId>"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.getServer("<slugOrId>");getUserProfileReads another user's profile.Arguments
Name Type Required args{ userId: string }Yes Returns
discordUserProfileinterface 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/getUserProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.getUserProfile({ userId: "1000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.getUserProfile({"userId": "1000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/discord/getUserProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"userId":"1000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listAppCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listAppCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listAppCategories())curl -X POST https://api.bowmark.ai/v1/sites/discord/listAppCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listBlogPostsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listBlogPosts();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listBlogPosts())curl -X POST https://api.bowmark.ai/v1/sites/discord/listBlogPosts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listBlogPosts();listChannelsLists one joined server's channels the caller can see.Arguments
Name Type Required 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/listChannelsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listChannels("1000000000000000000");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listChannels("1000000000000000000"))curl -X POST https://api.bowmark.ai/v1/sites/discord/listChannels \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"guildId":"1000000000000000000"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listDirectMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listDirectMessages();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listDirectMessages())curl -X POST https://api.bowmark.ai/v1/sites/discord/listDirectMessages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listDocPagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listDocPages();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listDocPages())curl -X POST https://api.bowmark.ai/v1/sites/discord/listDocPages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listFeaturedAppsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listFeaturedApps();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listFeaturedApps())curl -X POST https://api.bowmark.ai/v1/sites/discord/listFeaturedApps \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listFriendRequestsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listFriendRequests();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listFriendRequests())curl -X POST https://api.bowmark.ai/v1/sites/discord/listFriendRequests \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listFriendsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listFriends();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listFriends())curl -X POST https://api.bowmark.ai/v1/sites/discord/listFriends \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listFriends();listMentionsLists the recent messages that mentioned the caller across their servers.Arguments
Name Type Required 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/listMentionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listMentions();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listMentions())curl -X POST https://api.bowmark.ai/v1/sites/discord/listMentions \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listMentions();listMessagesReads a channel's or DM's recent messages, newest first, paging backwards.Arguments
Name Type Required args{ channelId: string; limit?: number }Yes Returns
discordChannelMessagesinterface 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/listMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listMessages({ channelId: "1000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listMessages({"channelId": "1000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/discord/listMessages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"channelId":"1000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listMyServersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listMyServers();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listMyServers())curl -X POST https://api.bowmark.ai/v1/sites/discord/listMyServers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listMyServers();listPinnedMessagesLists the messages pinned in a channel.Arguments
Name Type Required 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/listPinnedMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listPinnedMessages({ channelId: "1000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listPinnedMessages({"channelId": "1000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/discord/listPinnedMessages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"channelId":"1000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listQuestsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listQuests();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listQuests())curl -X POST https://api.bowmark.ai/v1/sites/discord/listQuests \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listQuests();listServerAnnouncementsLists the posts a server publishes to its public announcements page (discord.com/announcements/<serverId>).Arguments
Name Type Required serverIdstringYes Returns
discordServerAnnouncementsinterface 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/listServerAnnouncementsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listServerAnnouncements("889960284020699156");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listServerAnnouncements("889960284020699156"))curl -X POST https://api.bowmark.ai/v1/sites/discord/listServerAnnouncements \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"serverId":"889960284020699156"}'// The body of a run: the MCP run tool, or POST /v1/run return 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/listServerCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listServerCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listServerCategories())curl -X POST https://api.bowmark.ai/v1/sites/discord/listServerCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listServerCategories();listServerEventsLists a joined server's scheduled events.Arguments
Name Type Required 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/listServerEventsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listServerEvents({ guildId: "1000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listServerEvents({"guildId": "1000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/discord/listServerEvents \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"guildId":"1000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required opts{ category?: string; offset?: number }No Returns
discordServerSearchinterface 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/listServersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listServers();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listServers())curl -X POST https://api.bowmark.ai/v1/sites/discord/listServers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listServers();listSimilarAppsLists the apps the App Directory shows as similar to one app.Arguments
Name Type Required 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/listSimilarAppsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listSimilarApps("1211781489931452447");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listSimilarApps("1211781489931452447"))curl -X POST https://api.bowmark.ai/v1/sites/discord/listSimilarApps \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"id":"1211781489931452447"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listSimilarApps("1211781489931452447");listThreadsLists the active threads in a channel, or the posts in a forum channel.Arguments
Name Type Required args{ channelId: string; archived?: boolean; offset?: number }Yes Returns
discordThreadListinterface 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/listThreadsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listThreads({ channelId: "1000000000000000000" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listThreads({"channelId": "1000000000000000000"}))curl -X POST https://api.bowmark.ai/v1/sites/discord/listThreads \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"channelId":"1000000000000000000"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/listTrendingGamesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.listTrendingGames();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.listTrendingGames())curl -X POST https://api.bowmark.ai/v1/sites/discord/listTrendingGames \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.listTrendingGames();searchAppsSearches Discord's App Directory (discord.com/discovery/applications) for bots, games and activities by keyword.Arguments
Name Type Required querystringYes Returns
discordAppSearchinterface 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/searchAppsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.searchApps("midjourney");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.searchApps("midjourney"))curl -X POST https://api.bowmark.ai/v1/sites/discord/searchApps \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"midjourney"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ guildId?: string; channelId?: string; query?: string; authorId?: string; has?: "link" | "embed" | "file" | "image" | "video" | "sound" | "sticker" | "poll"; offset?: number }Yes Returns
discordMessageSearchinterface 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/searchMessagesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.searchMessages({ guildId: "1000000000000000000", query: "hello" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.searchMessages({"guildId": "1000000000000000000", "query": "hello"}))curl -X POST https://api.bowmark.ai/v1/sites/discord/searchMessages \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"guildId":"1000000000000000000","query":"hello"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.searchMessages({ guildId: "1000000000000000000", query: "hello" });searchServerMembersFinds members of a joined server by name.Arguments
Name Type Required 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/searchServerMembersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.searchServerMembers({ guildId: "1000000000000000000", query: "a" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.searchServerMembers({"guildId": "1000000000000000000", "query": "a"}))curl -X POST https://api.bowmark.ai/v1/sites/discord/searchServerMembers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"guildId":"1000000000000000000","query":"a"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required querystringYes opts{ category?: string; offset?: number }No Returns
discordServerSearchinterface 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/searchServersCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.searchServers("minecraft");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.searchServers("minecraft"))curl -X POST https://api.bowmark.ai/v1/sites/discord/searchServers \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"minecraft"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.searchServers("minecraft");
acceptFriendRequestAccepts a pending incoming friend request.Arguments
Name Type Required args{ userId: string }Yes Returns
discordRelationshipResultinterface 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/acceptFriendRequestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.acceptFriendRequest({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.acceptFriendRequest({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/acceptFriendRequest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.acceptFriendRequest({});addReactionAdds an emoji reaction to a message as the caller.Arguments
Name Type Required args{ channelId: string; messageId: string; emoji: string }Yes Returns
discordReactionResultinterface discordReactionResult { channelId: string; messageId: string; emoji: string; // as sent: "👍" or "name:id" ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discord/addReactionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.addReaction({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.addReaction({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/addReaction \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.addReaction({});blockUserBlocks a user.Arguments
Name Type Required args{ userId: string }Yes Returns
discordRelationshipResultinterface 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/blockUserCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.blockUser({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.blockUser({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/blockUser \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ channelId: string; expiresInSeconds?: number; useLimit?: number }Yes Returns
discordCreatedInviteinterface 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/createInviteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.createInvite({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.createInvite({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/createInvite \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.createInvite({});createServerCreates a new server owned by the caller, with a name and optional icon.Arguments
Name Type Required args{ name: string; icon?: string }Yes Returns
discordCreatedServerinterface 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/createServerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.createServer({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.createServer({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/createServer \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.createServer({});createThreadStarts a thread from a message, or a new post in a forum channel, as the caller.Arguments
Name Type Required args{ channelId: string; name: string; messageId?: string; content?: string; tagIds?: string[] }Yes Returns
discordThreadinterface 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/createThreadCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.createThread({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.createThread({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/createThread \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.createThread({});deleteMessageDeletes a message the caller sent (or, with the permission, anyone's in a server they moderate).Arguments
Name Type Required args{ channelId: string; messageId: string }Yes Returns
discordDeleteResultinterface discordDeleteResult { channelId: string; messageId: string; deleted: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discord/deleteMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.deleteMessage({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.deleteMessage({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/deleteMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.deleteMessage({});editMessageEdits the text of a message the caller sent.Arguments
Name Type Required args{ channelId: string; messageId: string; content: string }Yes Returns
discordMessageinterface 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/editMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.editMessage({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.editMessage({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/editMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.editMessage({});joinServerJoins a server from an invite code or link as the caller.Arguments
Name Type Required args{ invite: string }Yes Returns
discordJoinResultinterface 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/joinServerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.joinServer({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.joinServer({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/joinServer \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.joinServer({});leaveServerLeaves a server the caller has joined.Arguments
Name Type Required args{ guildId: string }Yes Returns
discordLeaveResultinterface discordLeaveResult { guildId: string; left: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discord/leaveServerCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.leaveServer({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.leaveServer({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/leaveServer \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.leaveServer({});removeFriendRemoves a friend, or cancels or declines a pending request.Arguments
Name Type Required args{ userId: string }Yes Returns
discordRelationshipResultinterface 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/removeFriendCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.removeFriend({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.removeFriend({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/removeFriend \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.removeFriend({});removeReactionRemoves the caller's own emoji reaction from a message.Arguments
Name Type Required args{ channelId: string; messageId: string; emoji: string }Yes Returns
discordReactionResultinterface discordReactionResult { channelId: string; messageId: string; emoji: string; // as sent: "👍" or "name:id" ok: true; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discord/removeReactionCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.removeReaction({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.removeReaction({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/removeReaction \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ userId: string; content: string }Yes Returns
discordMessageinterface 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/sendDirectMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.sendDirectMessage({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.sendDirectMessage({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/sendDirectMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.sendDirectMessage({});sendFriendRequestSends a friend request to a user by username.Arguments
Name Type Required args{ username?: string; userId?: string }Yes Returns
discordRelationshipResultinterface 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/sendFriendRequestCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.sendFriendRequest({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.sendFriendRequest({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/sendFriendRequest \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required args{ channelId: string; content: string; replyToMessageId?: string }Yes Returns
discordMessageinterface 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/sendMessageCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.sendMessage({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.sendMessage({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/sendMessage \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.sendMessage({});setAvatarChanges the caller's profile picture.Arguments
Name Type Required args{ image: string | null }Yes Returns
discordAvatarResultinterface discordAvatarResult { userId: string | null; avatar: string | null; // hash; null = avatar removed avatarUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discord/setAvatarCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.setAvatar({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.setAvatar({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/setAvatar \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.setAvatar({});setStatusSets the caller's presence (online, idle, do not disturb, invisible) and custom status text.Arguments
Name Type Required args{ status?: 'online' | 'idle' | 'dnd' | 'invisible'; text?: string | null }Yes Returns
discordStatusResultinterface discordStatusResult { status: "online" | "idle" | "dnd" | "invisible" | null; customStatus: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discord/setStatusCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.setStatus({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.setStatus({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/setStatus \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.setStatus({});updateProfileChanges the caller's display name, bio (About Me) or pronouns.Arguments
Name Type Required args{ displayName?: string; bio?: string; pronouns?: string }Yes Returns
discordProfileResultinterface discordProfileResult { userId: string | null; displayName: string | null; bio: string | null; pronouns: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/discord/updateProfileCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.discord.updateProfile({});import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.discord.updateProfile({}))curl -X POST https://api.bowmark.ai/v1/sites/discord/updateProfile \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.discord.updateProfile({});
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/discord/<function> - OpenAPI
/v1/sites/discord/openapi.json