send_text_message

Send plain text messages to DingTalk group chats with optional @mentions for specific users or all members.

Instructions

Send a plain text message

Input Schema

TableJSON Schema

Name	Required	Description
`text`	Yes	The text content to send
`atMobiles`	No	The mobile numbers of users to @mention (ping) individually in the group chat
`atAll`	No	Whether to @all the users in the group

Implementation Reference

src/index.ts:30-41 (handler)

Handler function for 'send_text_message' tool that invokes DingtalkBot.sendText and formats MCP response

  async ({ text, atMobiles, atAll }) => {
    const response = await dingtalkBot.sendText(text, atMobiles, atAll);
    if (response.errcode !== 0) {
      return {
        content: [{ type: "text", text: `Failed to send message, code: ${response.errcode}, message: ${response.errmsg}` }],
      };
    }
    return {
      content: [{ type: "text", text: "Message sent successfully" }],
    };
  }
);

src/index.ts:25-29 (schema)

Input schema (zod) for send_text_message tool

{
  text: z.string().describe("The text content to send"),
  atMobiles: z.array(z.string()).optional().describe("The mobile numbers of users to @mention (ping) individually in the group chat"),
  atAll: z.boolean().optional().describe("Whether to @all the users in the group"),
},

src/index.ts:22-41 (registration)

Registration of send_text_message tool using server.tool() including schema and handler

server.tool(
  'send_text_message',
  'Send a plain text message',
  {
    text: z.string().describe("The text content to send"),
    atMobiles: z.array(z.string()).optional().describe("The mobile numbers of users to @mention (ping) individually in the group chat"),
    atAll: z.boolean().optional().describe("Whether to @all the users in the group"),
  },
  async ({ text, atMobiles, atAll }) => {
    const response = await dingtalkBot.sendText(text, atMobiles, atAll);
    if (response.errcode !== 0) {
      return {
        content: [{ type: "text", text: `Failed to send message, code: ${response.errcode}, message: ${response.errmsg}` }],
      };
    }
    return {
      content: [{ type: "text", text: "Message sent successfully" }],
    };
  }
);

src/dingtalk_custom_robot.ts:56-80 (helper)

DingtalkBot.sendText method implementing the core logic for sending text messages to DingTalk robot API, called by the tool handler

async sendText(
  content: string,
  atMobiles?: string[],
  atAll: boolean = false
): Promise<MessageResponse> {
  const data: TextMessage = {
    msgtype: 'text',
    text: {
      content,
    },
    at: {
      atMobiles: atMobiles || [],
      isAtAll: atAll,
    },
  };

  const response = await fetch(this.getSignedUrl(), {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(data),
  });
  return response.json() as Promise<MessageResponse>;
}

mcp-dingding-bot