ClickSend MCP Server

Instructions

Implementation Reference

• src/client.ts:30-50 (handler)

  The core handler function in ClickSendClient that executes the SMS sending logic via the ClickSend API, including payload construction and error handling.
  async sendSMS(params: SMSMessage) { const payload = { messages: [ { source: 'mcp', body: params.message, to: params.to } ] }; try { const response = await this.client.post('/sms/send', payload); return response.data; } catch (error) { if (axios.isAxiosError(error)) { throw new Error(`ClickSend API Error: ${error.response?.data?.message || error.message}`); } throw error; } }
• src/index.ts:65-82 (registration)

  Registration of the 'send_sms' tool in the ListTools handler, including name, description, and input schema.
  name: 'send_sms', description: 'Send SMS messages via ClickSend', inputSchema: { type: 'object', properties: { to: { type: 'string', description: 'Phone number in E.164 format (e.g. +61423456789)' }, message: { type: 'string', description: 'Message content to send' } }, required: ['to', 'message'], additionalProperties: false } },
• src/index.ts:116-128 (handler)

  Server-side dispatch handler for 'send_sms' tool calls, including validation and delegation to client.sendSMS.
  case 'send_sms': { const { to, message } = request.params.arguments as { to: string; message: string }; validateSMSParams(to, message); const result = await this.client.sendSMS({ to, message }); return { content: [ { type: 'text', text: `SMS sent successfully: ${JSON.stringify(result)}` } ] }; }
• src/client.ts:3-6 (schema)

  TypeScript interface defining the input parameters for sendSMS.
  export interface SMSMessage { to: string; message: string; }
• src/utils/validation.ts:19-26 (helper)

  Validation helper function for SMS parameters used in the tool handler.
  export function validateSMSParams(to: string, message: string): void { if (!validatePhoneNumber(to)) { throw new ValidationError('Invalid phone number format. Must be in E.164 format (e.g., +61423456789)'); } if (!validateMessage(message)) { throw new ValidationError('Invalid message. Must be between 1 and 1600 characters'); } }