send_linkedin_chat_message

Send direct messages to LinkedIn users through the HorizonDataWave API using account credentials from environment settings.

Instructions

Send a chat message via LinkedIn management API. Account ID is taken from environment.

Input Schema

TableJSON Schema

Name	Required	Description
`company`	No	Company URN where the account is admin (format: company:123456)
`text`	Yes	Message text
`timeout`	No	Timeout in seconds
`user`	Yes	Recipient user URN (must include prefix, e.g. fsd_profile:ACoAA...)

Implementation Reference

src/index.ts:862-895 (handler)

Registration and inline handler implementation for the 'send_linkedin_chat_message' tool. Normalizes and validates the recipient URN, constructs API payload with account_id and message text, sends POST request to the AnySite LinkedIn management chat message endpoint, and returns the API response or error.

server.tool(
  "send_linkedin_chat_message",
  "Send LinkedIn chat message (requires ACCOUNT_ID)",
  {
    user: z.string().describe("Recipient user URN (must include prefix)"),
    company: z.string().optional().describe("Company URN"),
    text: z.string().describe("Message text"),
    timeout: z.number().default(300).describe("Timeout in seconds")
  },
  async ({ user, company, text, timeout }) => {
    const normalizedUser = normalizeUserURN(user);
    if (!isValidUserURN(normalizedUser)) {
      return {
        content: [{ type: "text", text: "Invalid URN format. Must start with 'fsd_profile:'" }],
        isError: true
      };
    }
    const requestData: any = { timeout, user: normalizedUser, text, account_id: ACCOUNT_ID };
    if (company) requestData.company = company;
    log("Starting LinkedIn send chat message for user:", normalizedUser);
    try {
      const response = await makeRequest(API_CONFIG.ENDPOINTS.CHAT_MESSAGE, requestData);
      return {
        content: [{ type: "text", text: JSON.stringify(response, null, 2) }]
      };
    } catch (error) {
      log("LinkedIn send chat message error:", error);
      return {
        content: [{ type: "text", text: `LinkedIn send chat message API error: ${formatError(error)}` }],
        isError: true
      };
    }
  }
);

src/types.ts:57-62 (schema)
TypeScript interface defining the structure of input arguments for the send_linkedin_chat_message tool.
```
export interface SendLinkedinChatMessageArgs {
  user: string;
  company?: string;
  text: string;
  timeout?: number;
}
```

src/types.ts:519-529 (helper)

Type guard validation function for SendLinkedinChatMessageArgs inputs.

export function isValidSendLinkedinChatMessageArgs(
  args: unknown
): args is SendLinkedinChatMessageArgs {
  if (typeof args !== "object" || args === null) return false;
  const obj = args as Record<string, unknown>;
  if (typeof obj.user !== "string" || !obj.user.trim()) return false;
  if (obj.company !== undefined && typeof obj.company !== "string") return false;
  if (typeof obj.text !== "string" || !obj.text.trim()) return false;
  if (obj.timeout !== undefined && typeof obj.timeout !== "number") return false;
  return true;
}

src/index.ts:88-92 (helper)

Utility function used by the handler to normalize LinkedIn user URN by prepending 'fsd_profile:' if missing.

const normalizeUserURN = (urn: string): string => {
  if (!urn.includes("fsd_profile:")) {
    return `fsd_profile:${urn}`;
  }
  return urn;

src/index.ts:95-97 (helper)
Utility function used by the handler to validate if a URN starts with 'fsd_profile:'.
```
const isValidUserURN = (urn: string): boolean => {
  return urn.startsWith("fsd_profile:");
};
```

HDW MCP Server