Home / Servers / Discord API / guild_search

GET /guilds/{guild_id}/messages/search

An MCP tool from the Discord API server, hosted on mcp.hjlabs.in.

GET /guilds/{guild_id}/messages/search [GET /guilds/{guild_id}/messages/search]

Name on the gateway: discord_api__guild_search · read-only.

Parameters

NameTypeDescription
guild_id requiredstringguild_id parameter
sort_bystringsort_by parameter
sort_orderstringsort_order parameter
contentstringcontent parameter
slopintegerslop parameter
author_idarrayauthor_id parameter
author_typearrayauthor_type parameter
mentionsarraymentions parameter
mentions_role_idarraymentions_role_id parameter
replied_to_user_idarrayreplied_to_user_id parameter
replied_to_message_idarrayreplied_to_message_id parameter
mention_everyonebooleanmention_everyone parameter
min_idstringmin_id parameter
max_idstringmax_id parameter
limitintegerlimit parameter
offsetintegeroffset parameter
hasarrayhas parameter
link_hostnamearraylink_hostname parameter
embed_providerarrayembed_provider parameter
embed_typearrayembed_type parameter
attachment_extensionarrayattachment_extension parameter
attachment_filenamearrayattachment_filename parameter
pinnedbooleanpinned parameter
include_nsfwbooleaninclude_nsfw parameter
channel_idarraychannel_id parameter

How to call it

Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:

call_tool arguments
{
  "name": "discord_api__guild_search",
  "arguments": {
    "guild_id": "…"
  }
}

Or connect the Discord API server directly, which lists 250 tools including this one:

Run in your terminal
claude mcp add --transport http hj-discord-api https://mcp.hjlabs.in/mcp/discord-api \
  --header "Authorization: Bearer YOUR_API_KEY"

Try asking

Use the get /guilds/{guild_id}/messages/search tool with guild_id set to ….

More from Discord API