Revoke Invite Code

Instructions

Implementation Reference

• src/tools/revoke-invite-code.ts:10-31 (handler)

  The function that registers and implements the 'revoke_invite_code' tool. It defines the handler that POSTs to the Evolution API endpoint /group/revokeInviteCode/{instanceName}?groupJid=... to revoke and regenerate the invite code.

  export function registerRevokeInviteCode(server: McpServer, client: EvolutionClient): void {
    server.registerTool(
      "revoke_invite_code",
      {
        title: "Revoke Invite Code",
        description: "Revoke and regenerate the invite code for a WhatsApp group via the pinned instance.",
        inputSchema: schema,
      },
      async (args) => {
        try {
          const data = await client.post(
            `/group/revokeInviteCode/${client.instanceName}?groupJid=${encodeURIComponent(args.groupJid)}`,
            {}
          );
          return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
        } catch (e) {
          if (e instanceof McpError) return { isError: true, content: [{ type: "text" as const, text: e.message }] };
          throw e;
        }
      }
    );
  }

• src/tools/revoke-invite-code.ts:6-8 (schema)

  Input validation schema using Zod, requiring a non-empty string for groupJid.

  const schema = {
    groupJid: z.string().min(1).describe("Group JID (e.g. 120363000000000000@g.us)"),
  };

• src/tools/index.ts:49-122 (registration)

  Import of registerRevokeInviteCode in the central tools index file.

  import { registerRevokeInviteCode } from "./revoke-invite-code.js";
  import { registerAcceptInvite } from "./accept-invite.js";
  import { registerSendGroupInvite } from "./send-group-invite.js";
  import { registerUpdateParticipants } from "./update-participants.js";
  import { registerUpdateGroupSetting } from "./update-group-setting.js";
  import { registerLeaveGroup } from "./leave-group.js";
  import { registerFindGroupByInvite } from "./find-group-by-invite.js";
  
  // Instance
  import { registerConnectionState } from "./connection-state.js";
  import { registerRestartInstance } from "./restart-instance.js";
  import { registerLogoutInstance } from "./logout-instance.js";
  import { registerGetSettings } from "./get-settings.js";
  import { registerSetSettings } from "./set-settings.js";
  
  // Webhook
  import { registerFindWebhook } from "./find-webhook.js";
  import { registerSetWebhook } from "./set-webhook.js";
  
  // Label
  import { registerFindLabels } from "./find-labels.js";
  import { registerHandleLabel } from "./handle-label.js";
  
  // Block & Misc
  import { registerUpdateBlockStatus } from "./update-block-status.js";
  import { registerCheckNumber } from "./check-number.js";
  
  export function registerAllTools(server: McpServer, client: EvolutionClient): void {
    // Original
    registerListGroups(server, client);
    registerFindChats(server, client);
    registerFindContacts(server, client);
    registerFindMessages(server, client);
    registerGetChatHistory(server, client);
    registerSendText(server, client);
    registerSendMedia(server, client);
    registerGetGroupInfo(server, client);
    registerGetGroupResolvedParticipants(server, client);
  
    // Message
    registerSendAudio(server, client);
    registerSendSticker(server, client);
    registerSendLocation(server, client);
    registerSendContact(server, client);
    registerSendReaction(server, client);
    registerSendPoll(server, client);
    registerSendList(server, client);
    registerSendButton(server, client);
    registerSendStatus(server, client);
  
    // Chat
    registerMarkAsRead(server, client);
    registerArchiveChat(server, client);
    registerDeleteMessage(server, client);
    registerFetchProfilePicture(server, client);
    registerDownloadMedia(server, client);
    registerSendPresence(server, client);
  
    // Profile
    registerFetchBusinessProfile(server, client);
    registerUpdateProfileName(server, client);
    registerUpdateProfileStatus(server, client);
    registerUpdateProfilePicture(server, client);
    registerRemoveProfilePicture(server, client);
    registerFetchPrivacy(server, client);
    registerUpdatePrivacy(server, client);
  
    // Group
    registerCreateGroup(server, client);
    registerUpdateGroupSubject(server, client);
    registerUpdateGroupDescription(server, client);
    registerUpdateGroupPicture(server, client);
    registerFetchInviteCode(server, client);
    registerRevokeInviteCode(server, client);

• src/tools/index.ts:122-122 (registration)

  Registration call that wires the tool into the MCP server during initialization.

  registerRevokeInviteCode(server, client);