PyWA MCP Server

Instructions

Implementation Reference

• tools/messaging.py:215-245 (handler)

  The send_sticker handler function - decorated with @mcp.tool(), accepts 'to', 'sticker', and optional 'reply_to_message_id' parameters, calls wa_client.send_sticker() to send the sticker, and returns success status with message ID
  @mcp.tool() async def send_sticker( to: str, sticker: str, *, reply_to_message_id: Optional[str] = None, ) -> dict: """ Send a sticker message. Args: to: Phone number or WhatsApp ID sticker: Sticker URL or media ID (must be webp format) reply_to_message_id: Message ID to reply to Returns: Dictionary with success status and message ID """ try: result = wa_client.send_sticker( to=to, sticker=sticker, reply_to_message_id=reply_to_message_id, ) logger.info(f"Sticker sent to {to}") message_id = getattr(result, 'id', str(result)) if result else None return {"success": True, "message_id": message_id} except Exception as e: logger.error(f"Failed to send sticker: {str(e)}") return {"success": False, "error": str(e)}
• tools/messaging.py:11-13 (registration)

  The register_messaging_tools function that registers all messaging tools including send_sticker with the MCP server
  def register_messaging_tools(mcp, wa_client: WhatsApp): """Register all messaging-related tools."""